Project MCP Server

Project MCP Server

一个 MCP 服务实现，提供用于管理项目知识图谱的工具，可对项目、任务、里程碑、资源和团队成员进行结构化表示。此服务可帮助项目经理跟踪进度、管理风险、分配资源并做出明智的决策。

功能

• 持久化项目上下文：跨多个会话维护项目实体及其关系的结构化知识图谱
• 会话管理：通过唯一 ID 跟踪项目管理会话，并记录进度变化
• 项目状态跟踪：实时监控项目健康状况、风险和问题状态
• 任务依赖关系：可视化并管理任务间的依赖关系，以识别瓶颈
• 里程碑进度：跟踪关键项目里程碑的进度
• 资源分配：监控资源在项目和任务中的分配情况
• 风险评估：识别、监控并降低项目风险
• 决策日志：记录重要的项目决策及其背景
• 团队成员管理：跟踪团队成员的任务分配和工作量
• 项目时间线分析：分析项目时间线，包括关键路径

实体

Project MCP Server 支持以下实体类型：

• project：所有相关实体的主要容器
• task：需要完成的单项工作
• milestone：项目中的关键检查点或交付物
• resource：项目所需的材料、工具或资产
• teamMember：参与项目的人员
• note：文档、想法或观察记录
• document：正式的项目文档
• issue：问题或阻碍因素
• risk：未来可能出现的问题
• decision：项目期间做出的重要选择
• dependency：外部要求或前置条件
• component：项目的组成部分或模块
• stakeholder：受项目影响或对项目感兴趣的人员
• change：对项目范围或要求的修改
• status：实体状态值（inactive、active、complete）
• priority：优先级值（high、low）

关系

实体可通过以下关系类型连接：

• part_of：表示某个实体是另一个实体的组成部分／子集
• depends_on：表示实体之间的依赖关系
• assigned_to：将任务关联到团队成员
• created_by：记录实体的创建者
• modified_by：记录实体的修改者
• related_to：表示实体之间的一般关联
• blocks：表示某个实体阻碍了另一个实体
• manages：表示管理关系
• contributes_to：表示对实体的贡献
• documents：将文档关联到实体
• scheduled_for：将实体关联到日期或时间范围
• responsible_for：分配所有权／责任
• reports_to：表示汇报关系
• categorized_as：将实体关联到类别或类型
• required_for：表示完成所需的条件
• discovered_in：将问题关联到其发现情境
• resolved_by：表示解决某个问题的因素
• impacted_by：表示影响关系
• stakeholder_of：将利益相关者关联到项目／组件
• prioritized_as：表示优先级
• has_status：将实体关联到其当前状态（inactive、active、complete）
• has_priority：将实体关联到其优先级（high、low）
• precedes：表示一个任务在顺序上先于另一个任务

可用工具

Project MCP Server 提供以下工具，用于与项目知识交互：

startsession

启动新的项目管理会话，生成唯一的会话 ID，并显示当前项目、任务、里程碑、风险和近期会话。通过 has_status 关系显示状态信息，通过 has_priority 关系显示优先级，并根据顺序依赖关系确定接下来可开展的任务。

loadcontext

加载特定实体（项目、任务等）的详细上下文，并根据实体类型显示相关信息。包含状态信息（inactive、active、complete）、优先级（high、low）和顺序任务关系。

endsession

通过结构化的多阶段流程记录项目管理会话结果：

1. summary：记录会话摘要、时长和项目重点
2. achievements：记录会话中的关键成就
3. taskUpdates：跟踪现有任务的更新
4. newTasks：记录会话期间创建的新任务
5. statusUpdates：记录实体状态值的变更
6. projectStatus：更新整体项目状态、优先级分配和顺序关系
7. assembly：最终汇总所有会话数据

buildcontext

在知识图谱中创建实体、关系或观察：

• entities：添加新的项目相关实体（项目、任务、里程碑、状态、优先级等）
• relations：创建实体之间的关系（包括 has_status、has_priority、precedes）
• observations：向现有实体添加观察

deletecontext

从知识图谱中移除实体、关系或观察：

• entities：移除项目实体
• relations：移除实体之间的关系（包括状态、优先级和顺序关系）
• observations：从实体中移除特定观察

advancedcontext

从知识图谱中检索信息：

• graph：获取整个知识图谱
• search：根据查询条件搜索节点
• nodes：按名称获取特定节点
• related：查找相关实体
• status：查找具有特定状态值（inactive、active、complete）的实体
• priority：查找具有特定优先级值（high、low）的实体
• sequence：识别任务的顺序关系

特定领域功能

Project MCP Server 包含用于项目管理的专用领域功能：

• getProjectOverview：全面查看项目，包括任务、里程碑、团队成员、问题等
• getTaskDependencies：分析任务依赖关系，以识别受阻任务和关键路径
• getTeamMemberAssignments：查看特定团队成员的所有分配任务
• getMilestoneProgress：跟踪项目里程碑的进展
• getProjectTimeline：分析项目时间线和关键日期
• getResourceAllocation：检查项目中的资源分配情况
• getProjectRisks：识别并评估项目风险
• findRelatedProjects：发现不同项目之间的关联
• getDecisionLog：跟踪决策历史和上下文
• getProjectHealth：通过指标和建议评估项目整体健康状况
• getStatusOverview：查看所有具有特定状态（inactive、active、complete）的实体
• getPriorityItems：识别高优先级任务和活动
• getTaskSequence：根据 precedes 关系可视化任务顺序

示例提示词

开始会话

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

加载项目上下文

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

记录会话结果

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.

管理项目知识

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.

用法

此 MCP 服务使项目经理能够：

• 保持上下文连续性：在多个规划会议期间跟踪项目详情
• 让新团队成员快速上手：帮助新团队成员快速了解项目状态
• 记录会议结果：记录会议和工作会议的成果
• 跟踪依赖关系：识别并管理关键依赖关系和瓶颈
• 监控风险：跟踪项目风险并实施缓解策略
• 分配资源：优化项目和任务之间的资源分配
• 做出明智决策：基于全面的项目数据做出决策
• 跟踪进度：在整个项目生命周期中监控实体状态
• 确定工作优先级：识别并聚焦于高优先级任务
• 安排任务顺序：规划并可视化项目任务的逻辑顺序

配置

与 Claude Desktop 配合使用

将以下内容添加到 claude_desktop_config.json：

从 GitHub 安装并使用 npx 运行

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

全局安装并直接运行

首先，全局安装软件包：

npm install -g github:tejpalvirk/project

然后配置 Claude Desktop：

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

docker

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

构建

从源代码构建

# 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

Docker：

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

许可证

此 MCP 服务采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。

环境变量

Project MCP Server 支持以下环境变量，用于自定义数据存储位置：

• MEMORY_FILE_PATH：知识图谱数据的存储路径

  • 可以是绝对路径或相对路径（相对路径以当前工作目录为基准）
  • 默认值：./project/memory.json

• SESSIONS_FILE_PATH：会话数据的存储路径

  • 可以是绝对路径或相对路径（相对路径以当前工作目录为基准）
  • 默认值：./project/sessions.json

用法示例：

# 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