JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 67
  • Score
    100M100P100Q65986F
  • License MIT

MCP Server for DevBear - Project management integration for Claude Code and AI assistants

Package Exports

  • @dev-bear/mcp
  • @dev-bear/mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@dev-bear/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@dev-bear/mcp

MCP (Model Context Protocol) Server para integrar DevBear con Claude Code y otros asistentes de IA.

Instalacion Rapida

# Agregar a Claude Code (recomendado)
claude mcp add devbear npx @dev-bear/mcp

¡Eso es todo! No necesitas configurar nada mas.

Instalacion Alternativa

Opcion 1: Usar con npx (sin instalar)

npx @dev-bear/mcp

Opcion 2: Instalar globalmente

npm install -g @dev-bear/mcp
devbear-mcp

Opcion 3: Configuracion manual

Edita tu archivo de configuracion de Claude:

Ubicaciones:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "devbear": {
      "command": "npx",
      "args": ["@dev-bear/mcp"]
    }
  }
}

Primer Uso

1. Iniciar sesion

La primera vez que uses el MCP, necesitas autenticarte con tu cuenta de DevBear:

Tu: "Lista mis proyectos en DevBear"
Claude: "Necesitas autenticarte. Usa devbear_login con tu email y password"

Tu: devbear_login con email="tu@email.com", password="tu-password"
Claude: "Autenticado como Juan Perez (developer) en Mi Organizacion"

2. Sesiones siguientes

Tu sesion se guarda automaticamente. No necesitas hacer login cada vez.

Tu: "Lista mis proyectos"
Claude: [Usa tu sesion guardada automaticamente]

3. Ver tu usuario actual

Tu: devbear_whoami
Claude:
- Email: tu@email.com
- Nombre: Juan Perez
- Rol: developer
- Organizacion: Mi Organizacion

4. Cerrar sesion

Tu: devbear_logout
Claude: "Sesion cerrada correctamente"

Herramientas Disponibles

Autenticacion

Herramienta Descripcion
devbear_login Iniciar sesion
devbear_logout Cerrar sesion
devbear_whoami Ver usuario actual

Proyectos

Herramienta Descripcion
devbear_project_list Listar proyectos
devbear_project_get Detalles de proyecto
devbear_project_context Contexto completo para desarrollo

Tareas

Herramienta Descripcion
devbear_task_list Listar tareas
devbear_task_get Detalles de tarea
devbear_task_create Crear tarea
devbear_task_update Actualizar tarea
devbear_task_start Marcar en progreso
devbear_task_complete Marcar completada
devbear_task_add_comment Agregar comentario
devbear_subtask_list Listar subtareas

Documentos

Herramienta Descripcion
devbear_doc_list Listar documentos
devbear_doc_get Ver documento
devbear_doc_create Crear documento
devbear_doc_update Actualizar documento

Diagramas

Herramienta Descripcion
devbear_diagram_list Listar diagramas
devbear_diagram_get Ver diagrama (Mermaid)
devbear_diagram_create Crear diagrama
devbear_diagram_update Actualizar diagrama

Prompts y Skills

Herramienta Descripcion
devbear_prompt_list Listar prompts
devbear_prompt_get Ver prompt
devbear_prompt_create Guardar prompt
devbear_prompt_delete Eliminar prompt
devbear_prompt_search_by_tech Buscar por tecnologia

Metricas

Herramienta Descripcion
devbear_metrics_get Metricas del proyecto
devbear_project_report Reporte completo
devbear_ai_activity_summary Resumen de actividad IA

Ejemplos de Uso

"Muestrame los proyectos activos"
"Dame el contexto del proyecto mi-app"
"Lista las tareas pendientes"
"Crea una tarea: Implementar login con Google"
"Marca la tarea ABC como completada"
"Agrega un comentario a la tarea: Avance del 50%"
"Busca prompts de React y TypeScript"
"Muestrame el diagrama de arquitectura"

Permisos (RBAC)

El MCP respeta los permisos de tu cuenta:

Accion Admin Leader Developer Viewer
Ver proyectos ✅ ✅ ✅ ✅
Crear tareas ✅ ✅ ✅ ❌
Editar cualquier tarea ✅ ✅ ❌ ❌
Editar tus tareas ✅ ✅ ✅ ❌
Eliminar ✅ Solo propios Solo propios ❌

Donde se guardan los datos

Dato Ubicacion Acceso
Tu sesion ~/.devbear/tokens.json (tu PC) Solo tu
Tus proyectos Servidores de DevBear Tu + tu equipo
Codigo del MCP npm Publico

Importante: Tus datos NUNCA pasan por npm. El MCP es solo codigo que conecta Claude con DevBear.

Solucion de Problemas

"No autenticado"

devbear_login con email="tu@email.com", password="..."

"Acceso denegado"

Tu rol no tiene permisos. Contacta a un admin de tu organizacion.

"Token expirado"

El MCP refresca automaticamente. Si falla:

devbear_logout
devbear_login con email="...", password="..."

Limpiar sesion manualmente

# macOS/Linux
rm ~/.devbear/tokens.json

# Windows
del %USERPROFILE%\.devbear\tokens.json

Requisitos

Self-Hosted (Avanzado)

Si tienes tu propia instancia de DevBear:

SUPABASE_URL=https://tu-instancia.supabase.co \
SUPABASE_ANON_KEY=tu-anon-key \
npx @dev-bear/mcp

Enlaces

Licencia

MIT