Developer MCP Server

Un sistema de gestión de contexto diseñado para equipos de desarrollo de software con almacenamiento de datos personalizable.

GitHub
5

Documentación

Developer MCP Server

Sistema de gestión de contexto diseñado para equipos de desarrollo de software. El Developer MCP Server mantiene contexto persistente entre sesiones de codificación, asegurando que nunca pierdas el rastro de la estructura, dependencias y progreso del proyecto.

Developer Server MCP server

Características

  • Contexto de Desarrollo Persistente: Retoma exactamente donde lo dejaste en tu última sesión, con contexto completo sobre los componentes, problemas y tareas en los que estabas trabajando.

  • Gestión de Sesiones: Inicia nuevas sesiones de desarrollo y registra tus logros, actualizaciones de tareas y cambios de estado del proyecto al finalizar, creando un registro persistente de tus actividades de desarrollo.

  • Seguimiento de Dependencias: Comprende cómo se relacionan los componentes, características y tecnologías entre sí con un modelo integral de dependencias.

  • Información del Estado del Proyecto: Obtén visibilidad inmediata del progreso del proyecto, incluido el estado de componentes, características, problemas e hitos.

  • Recuperación de Contexto de Componentes: Comprende el propósito, los detalles de implementación, las dependencias y los problemas relacionados de cualquier componente de un vistazo.

  • Historial de Decisiones: Rastrea por qué se tomaron las decisiones arquitectónicas y de implementación, cuándo y por quién: no más adivinanzas sobre por qué algo se construyó de cierta manera.

  • Seguimiento de Progreso de Hitos: Monitorea el progreso hacia los hitos del proyecto e identifica posibles cuellos de botella antes de que descarrilen tu cronograma.

  • Descubrimiento de Entidades Relacionadas: Encuentra rápidamente todas las entidades relacionadas para cualquier componente, característica o tarea para comprender su contexto completo.

Entidades

El Developer MCP Server reconoce los siguientes tipos de entidades en tu contexto de desarrollo de software:

  • Project: Proyecto de software general o producto
  • Component: Módulo, servicio, paquete o unidad lógica dentro de un proyecto
  • Feature: Funcionalidad específica que se está desarrollando
  • Issue: Error, problema o defecto a abordar
  • Task: Elemento de trabajo o actividad necesaria para el desarrollo
  • Developer: Miembro del equipo que trabaja en el proyecto
  • Technology: Lenguaje de programación, framework, biblioteca o herramienta
  • Decision: Decisión técnica o arquitectónica importante
  • Milestone: Fecha límite o fase clave del proyecto
  • Environment: Entorno de desarrollo, staging o producción
  • Documentation: Recurso de documentación del proyecto
  • Requirement: Requisito o especificación del proyecto

Relaciones

El Developer MCP Server modela las siguientes relaciones entre entidades, reflejando las dinámicas reales del desarrollo de software:

  • depends_on: La entidad A requiere la entidad B para funcionar
  • implements: El componente implementa una característica
  • assigned_to: La tarea está asignada a un desarrollador
  • blocked_by: La tarea está bloqueada por un problema
  • uses: El componente utiliza una tecnología
  • part_of: El componente es parte de un proyecto
  • contains: El proyecto contiene un componente
  • works_on: El desarrollador trabaja en un proyecto/componente
  • related_to: Relación general entre entidades
  • affects: El problema afecta a un componente
  • resolves: La tarea resuelve un problema
  • created_by: La entidad fue creada por un desarrollador
  • documented_in: El componente está documentado en la documentación
  • decided_in: La decisión se tomó en una reunión
  • required_by: La característica es requerida por un requisito
  • has_status: La entidad tiene un estado particular
  • depends_on_milestone: La tarea depende de alcanzar un hito
  • precedes: La tarea precede a otra tarea (secuenciación)
  • reviews: El desarrollador revisa un componente
  • tested_in: El componente se prueba en un entorno

Variables de Entorno

El Developer MCP Server admite las siguientes variables de entorno para personalizar dónde se almacenan los datos:

  • MEMORY_FILE_PATH: Ruta donde se almacenarán los datos del grafo de conocimiento

    • Puede ser absoluta o relativa (las rutas relativas usan el directorio de trabajo actual)
    • Predeterminado: ./developer/memory.json

  • SESSIONS_FILE_PATH: Ruta donde se almacenarán los datos de sesión

    • Puede ser absoluta o relativa (las rutas relativas usan el directorio de trabajo actual)
    • Predeterminado: ./developer/sessions.json

Ejemplo de uso:

# Store data in the current directory
MEMORY_FILE_PATH="./dev-memory.json" SESSIONS_FILE_PATH="./dev-sessions.json" npx github:tejpalvirk/contextmanager-developer

# Store data in a specific location (absolute path)
MEMORY_FILE_PATH="/path/to/data/developer-memory.json" npx github:tejpalvirk/contextmanager-developer

# Store data in user's home directory
MEMORY_FILE_PATH="$HOME/contextmanager/developer-memory.json" npx github:tejpalvirk/contextmanager-developer

Herramientas Disponibles

El Developer MCP Server proporciona las siguientes herramientas:

  • startsession: Inicia una nueva sesión de desarrollo y proporciona información sobre sesiones recientes, proyectos activos, tareas de alta prioridad y próximos hitos.

  • loadcontext: Carga el contexto detallado de una entidad (proyecto, componente, característica, tarea, etc.) y registra esta carga de contexto como parte de la sesión actual.

  • endsession: Realiza un análisis estructurado de la sesión de desarrollo a través de múltiples etapas (resumen, logros, actualizaciones de tareas, nuevas tareas, estado del proyecto) y registra esta información en el grafo de conocimiento persistente.

  • buildcontext: Crea nuevas entidades, relaciones u observaciones en el grafo de conocimiento.

  • deletecontext: Elimina entidades, relaciones u observaciones del grafo de conocimiento.

  • advancedcontext: Recupera información del grafo de conocimiento con diferentes tipos de consulta (grafo, búsqueda, nodos, relacionados, decisiones, hitos).

Indicaciones

Estos son algunos ejemplos de indicaciones para usar con el Developer MCP Server:

Iniciar una Sesión

"Start a new development session for me."

Cargar Contexto

"Show me the current status of the AuthService project."
"Load the context for the UserProfile component."
"What are the open issues affecting the Payment feature?"
"Show me details about the upcoming Q2 Release milestone."

Registrar el Progreso de la Sesión

"End my development session. I've been working on AuthService for 3 hours and completed user authentication flow implementation."
"Record my achievements for today: implemented password reset feature and fixed login redirect bug."
"Update the status of these tasks: Login Form is complete, User Registration is in progress."
"Create new tasks for the next sprint: Implement MFA, Add social login options."

Gestión del Grafo de Conocimiento

"Create a new feature called 'BillingSystem' in the ProjectX project."
"Create a relationship showing that PaymentComponent implements BillingSystem feature."
"Show me all components that depend on the DatabaseService."
"What decisions have been made about the authentication approach for ProjectX?"

Uso

El Developer MCP Server destaca en escenarios como:

Continuidad de Contexto

"Let me see the component I was working on yesterday and all its dependencies."

El servidor recupera tus componentes de acceso más reciente junto con sus dependencias, problemas y tareas relacionadas, permitiéndote reanudar el trabajo al instante sin dedicar tiempo a reconstruir el contexto.

Incorporación de Nuevos Miembros del Equipo

"Give me an overview of Project X's architecture and component structure."

Los nuevos desarrolladores pueden comprender rápidamente la estructura del proyecto, los componentes clave y sus relaciones, reduciendo drásticamente el tiempo necesario para ser productivos en un nuevo código base.

Registro de Sesiones

"End my development session and record what I accomplished."

El servidor te guía a través de un proceso estructurado para documentar tus logros, actualizaciones de tareas y cambios de estado del proyecto, preservando este contexto para futuras sesiones y miembros del equipo.

Contexto de Decisiones Arquitectónicas

"Why was GraphQL chosen over REST for the API layer?"

El servidor recupera la entidad de decisión junto con las reuniones relacionadas, los desarrolladores involucrados y el contexto en el que se tomó la decisión, preservando el conocimiento organizacional que de otro modo se perdería.

Análisis de Dependencias

"What would be affected if we modify the authentication service?"

Antes de realizar cambios, los desarrolladores pueden comprender todos los componentes, características y tareas que dependen de un componente en particular, reduciendo el riesgo de roturas inesperadas.

Seguimiento del Progreso del Proyecto

"What's our progress toward the Q2 release milestone?"

Los líderes de proyecto pueden ver al instante el estado de todas las tareas y características asociadas con un hito, identificando elementos en riesgo antes de que comprometan el cronograma.

Configuración

Uso con Claude Desktop

Añade esto a tu claude_desktop_config.json:

Instalar desde GitHub y ejecutar con npx

{
  "mcpServers": {
    "developer": {
      "command": "npx",
      "args": [
        "-y",
        "github:tejpalvirk/developer"
      ]
    }
  }
}

Instalar globalmente y ejecutar directamente

Primero, instala el paquete globalmente:

npm install -g github:tejpalvirk/contextmanager/developer

Luego configura Claude Desktop:

{
  "mcpServers": {
    "developer": {
      "command": "contextmanager-developer"
    }
  }
}

docker

{
  "mcpServers": {
    "developer": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/developer"
      ]
    }
  }
}

Compilación

Desde el Código Fuente

# Clone the repository
git clone https://github.com/tejpalvirk/contextmanager.git
cd contextmanager

# Install dependencies
npm install

# Build the server
npm run build

# Run the server
cd developer
node developer_index.js

Docker:

docker build -t mcp/developer -f developer/Dockerfile .

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.