Proyecto MCP Server

Una implementación de servidor MCP que proporciona herramientas para gestionar gráficos de conocimiento de proyectos, lo que permite una representación estructurada de proyectos, tareas, hitos, recursos y miembros del equipo. Este servidor ayuda a los gestores de proyectos a monitorizar el progreso, gestionar riesgos, asignar recursos y tomar decisiones informadas.

Características

Contexto de proyecto persistente : mantenga un gráfico de conocimiento estructurado de las entidades y relaciones del proyecto en múltiples sesiones
Gestión de sesiones : realice un seguimiento de las sesiones de gestión de proyectos con identificadores únicos y registre el progreso a lo largo del tiempo
Seguimiento del estado del proyecto : supervise la salud del proyecto, los riesgos y el estado de los problemas en tiempo real
Dependencias de tareas : visualice y administre las dependencias entre tareas para identificar cuellos de botella
Progreso de los hitos : realice un seguimiento del progreso hacia los hitos clave del proyecto
Asignación de recursos : supervise cómo se distribuyen los recursos entre proyectos y tareas
Evaluación de riesgos : identificar, monitorear y mitigar los riesgos del proyecto
Registro de decisiones : registre decisiones importantes del proyecto y su contexto
Gestión de miembros del equipo : realice un seguimiento de las asignaciones y cargas de trabajo de los miembros del equipo
Análisis de la línea de tiempo del proyecto : Analice las líneas de tiempo del proyecto, incluidas las rutas críticas

Entidades

El servidor Project MCP reconoce los siguientes tipos de entidades:

proyecto : El contenedor principal para todas las entidades relacionadas
Tarea : Elementos de trabajo individuales que deben completarse
hito : puntos de control o entregables clave en el proyecto
recurso : Materiales, herramientas o activos necesarios para el proyecto
teamMember : Personas involucradas en el proyecto
nota : Documentación, ideas u observaciones
documento : Documentos formales del proyecto
Problema : Problemas o bloqueadores
riesgo : posibles problemas futuros
decisión : Decisiones importantes tomadas durante el proyecto
dependencia : Requisitos externos o prerrequisitos
componente : Partes o módulos del proyecto
parte interesada : personas afectadas o interesadas en el proyecto
cambio : Modificaciones al alcance o requisitos del proyecto
estado : Valores de estado de la entidad (inactivo, activo, completo)
prioridad : Valores de nivel de prioridad (alto, bajo)

Relaciones

Las entidades se pueden conectar a través de los siguientes tipos de relaciones:

part_of : Indica que una entidad es un componente/subconjunto de otra
depends_on : Muestra dependencias entre entidades
assignment_to : Vincula tareas a miembros del equipo
created_by : rastrea quién creó una entidad
modified_by : Registra quién cambió una entidad
related_to : Muestra conexiones generales entre entidades
bloques : indica que una entidad está bloqueando a otra
administra : muestra las relaciones de gestión
contributes_to : Muestra contribuciones a entidades
documentos : Vincula la documentación a las entidades
programado_para : conecta entidades a fechas o períodos de tiempo
responsable_de : Asigna propiedad/responsabilidad
reports_to : Indica relaciones de informes
categorized_as : Vincula entidades a categorías o tipos
required_for : Muestra los requisitos para completar
discover_in : vincula los problemas con su contexto de descubrimiento
solved_by : Muestra qué resolvió un problema
impacted_by : Muestra las relaciones de impacto
stakeholder_of : vincula a las partes interesadas con proyectos/componentes
priority_as : Indica niveles de prioridad
has_status : Vincula las entidades a su estado actual (inactivo, activo, completo)
has_priority : vincula entidades a su nivel de prioridad (alto, bajo)
precede : Indica que una tarea viene antes de otra en una secuencia

Herramientas disponibles

El servidor MCP del proyecto proporciona estas herramientas para interactuar con el conocimiento del proyecto:

inicio de sesión

Inicia una nueva sesión de gestión de proyectos, generando un ID de sesión único y mostrando los proyectos, tareas, hitos, riesgos y sesiones recientes actuales. Muestra información de estado mediante relaciones has_status, niveles de prioridad mediante relaciones has_priority e identifica tareas listas para trabajar a continuación según dependencias secuenciales.

contexto de carga

Carga el contexto detallado de una entidad específica (proyecto, tarea, etc.) y muestra información relevante según el tipo de entidad. Incluye información de estado (inactivo, activo, completado), niveles de prioridad (alto, bajo) y relaciones secuenciales de tareas.

fin de sesión

Registra los resultados de una sesión de gestión de proyectos a través de un proceso estructurado de múltiples etapas:

Resumen : Registra el resumen de la sesión, la duración y el enfoque del proyecto.
Logros : Documenta los logros clave de la sesión.
taskUpdates : realiza un seguimiento de las actualizaciones de las tareas existentes
newTasks : Registra las nuevas tareas creadas durante la sesión
statusUpdates : Registra los cambios en los valores de estado de la entidad
projectStatus : actualiza el estado general del proyecto, las asignaciones de prioridad y las relaciones secuenciales
ensamblaje : ensamblaje final de todos los datos de la sesión

contexto de construcción

Crea nuevas entidades, relaciones u observaciones en el gráfico de conocimiento:

Entidades : agrega nuevas entidades relacionadas con el proyecto (proyectos, tareas, hitos, estado, prioridad, etc.)
relaciones : Crea relaciones entre entidades (incluyendo has_status, has_priority, precedes)
observaciones : Agregar observaciones a entidades existentes

eliminar contexto

Elimina entidades, relaciones u observaciones del gráfico de conocimiento:

entidades : Eliminar entidades del proyecto
relaciones : eliminar relaciones entre entidades (incluidas relaciones de estado, prioridad y secuenciales)
observaciones : eliminar observaciones específicas de las entidades

contexto avanzado

Recupera información del gráfico de conocimiento:

gráfico : Obtenga el gráfico de conocimiento completo
búsqueda : busca nodos según criterios de consulta
nodos : obtener nodos específicos por nombre
relacionado : Encuentra entidades relacionadas
estado : busca entidades con un valor de estado específico (inactivo, activo, completo)
prioridad : busca entidades con un valor de prioridad específico (alto, bajo)
secuencia : Identificar relaciones secuenciales para las tareas

Funciones específicas del dominio

El servidor Project MCP incluye funciones de dominio especializadas para la gestión de proyectos:

getProjectOverview : vista completa de un proyecto que incluye tareas, hitos, miembros del equipo, problemas, etc.
getTaskDependencies : analiza las dependencias de las tareas para identificar tareas bloqueadas y rutas críticas
getTeamMemberAssignments : Ver todas las asignaciones de un miembro específico del equipo
getMilestoneProgress : Realiza un seguimiento del progreso hacia los hitos del proyecto
getProjectTimeline : Analiza la cronología del proyecto y las fechas clave
getResourceAllocation : examina cómo se asignan los recursos en todo el proyecto
getProjectRisks : Identificar y evaluar los riesgos del proyecto
findRelatedProjects : Descubre conexiones entre diferentes proyectos
getDecisionLog : Seguimiento del historial y contexto de decisiones
getProjectHealth : evalúa el estado general del proyecto con métricas y recomendaciones
getStatusOverview : Ver todas las entidades con un estado específico (inactivo, activo, completo)
getPriorityItems : Identifica tareas y actividades de alta prioridad
getTaskSequence : Visualiza la secuencia de tareas basándose en relaciones previas

Ejemplos de indicaciones

Iniciar una sesión

Let's start a new project management session to review the Mobile App Development project.

Cargando el contexto del proyecto

Load the context for the Mobile App Development project so I can see its current status.

Resultados de la sesión de grabación

I've just finished a project review meeting for Mobile App Development. We completed the UI design milestone, identified 2 new risks related to the backend API, and assigned 3 new tasks to the development team. The UI tasks are now marked as complete, and we've set the API development tasks as high priority. The project is still on track but we need to monitor the API risks closely.

Gestión del conocimiento del proyecto

Create a new task called "Implement User Authentication" that's part of the Mobile App Development project, assigned to Sarah, with high priority and due in two weeks. Set its status to active and make it precede the "User Profile" task.

Update the status of the "Database Migration" task to "completed" and add an observation that it was finished ahead of schedule.

Uso

Este servidor MCP permite a los administradores de proyectos:

Mantener la continuidad del contexto : realizar un seguimiento de los detalles del proyecto en múltiples sesiones de planificación
Incorporar nuevos miembros al equipo : informe rápidamente a los nuevos miembros del equipo sobre el estado del proyecto.
Registrar los resultados de las sesiones : documentar los resultados de las reuniones y sesiones de trabajo
Seguimiento de dependencias : identificar y gestionar dependencias críticas y cuellos de botella
Monitorear el riesgo : Realizar un seguimiento de los riesgos del proyecto e implementar estrategias de mitigación
Asignar recursos : optimice la asignación de recursos entre proyectos y tareas
Tome decisiones informadas : base sus decisiones en datos completos del proyecto
Seguimiento del progreso : supervise el estado de la entidad durante todo el ciclo de vida del proyecto
Priorizar el trabajo : identificar y centrarse en las tareas de alta prioridad
Secuenciar tareas : planificar y visualizar el orden lógico de las tareas del proyecto

Configuración

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

Instalar desde GitHub y ejecutar con npx

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

Instalar globalmente y ejecutar directamente

Primero, instale el paquete globalmente:

npm install -g github:tejpalvirk/project

A continuación configure Claude Desktop:

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

estibador

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

Edificio

De la 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 project
node project_index.js

Estibador:

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

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

Variables de entorno

El servidor Project MCP 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 gráfico de conocimiento
- Puede ser absoluto o relativo (las rutas relativas utilizan el directorio de trabajo actual)
- Predeterminado: ./project/memory.json
SESSIONS_FILE_PATH : Ruta donde se almacenarán los datos de la sesión
- Puede ser absoluto o relativo (las rutas relativas utilizan el directorio de trabajo actual)
- Predeterminado: ./project/sessions.json

Ejemplo de uso:

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

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

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

Project MCP Server

Integrations