AI导哈

项目任务管理工具

MCP项目管理器是一款基于模型上下文协议（MCP）的AI辅助项目任务管理工具，支持任务分解、依赖跟踪和智能工作流管理。

  • by croffasia
  • TypeScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 croffasia/mcp-project-manager

使用说明

🚀 MCP项目经理

基于模型上下文协议（MCP）的分层任务管理

将任何兼容MCP的AI助手转变为强大的项目经理 自动化任务分解、依赖关系跟踪和智能工作流管理。

兼容： 克劳德代码•克劳德桌面•光标•VS代码+复制品• Continue.dev•任何MCP客户端

📖 文档

✨ 主要特点

🎯 分层项目管理：想法→ 史诗→ 智能任务 分解
🤖 AI驱动的任务创建：使用自然语言自动细分 鼓励
📊 智能依赖跟踪：自动任务排序和拦截器 检测
⚡ NPX就绪：零安装部署 npx mcp-project-manager
🖥️ 交互式CLI仪表板：实时项目可视化和 导航
🔄 状态管理：待定→ 进行中→ 完成进度跟踪
🛡️ 审批工作流程：用户控制所有AI操作和修改

🚀 快速开始

先决条件

  • 任何与MCP兼容的工具（见下面支持的工具）
  • Node.js 18+（自动包含NPX）

📁 数据存储

重要提示： 了解任务数据的存储位置：

  • 没有 MCP_TASK_DATA_DIR：存储在当前项目目录中的数据 AI在哪里工作
  • 随着 MCP_TASK_DATA_DIR：存储在指定绝对路径中的数据

何时使用每种方法：

✅ 使用当前目录（否 MCP_TASK_DATA_DIR):

  • 从事特定项目
  • 希望任务数据与代码放在一起
  • 使用游标、VS代码或其他基于项目的工具

✅ 使用自定义目录(MCP_TASK_DATA_DIR):

  • 必需 适用于Claude Desktop（只读环境）
  • 集中管理多个项目
  • 想要共享任务管理位置

🚀 安装方法

方法1:NPX（推荐）

简单使用 npx mcp-project-manager 在您的MCP客户端配置中，NPX将 为您处理下载和运行服务器。

方法2：克隆存储库

对于开发或定制：

git clone https://github.com/croffasia/mcp-project-manager.git
cd mcp-project-manager
npm install
npm run build

配置

此MCP服务器可与任何兼容MCP的工具配合使用。以下是最受欢迎的 选项：

支持的工具

🔷 克劳德代码 （推荐）

添加到您的Claude代码配置（Claude.md或项目设置）：

{
    "mcpServers": {
        "pm": {
            "command": "npx",
            "args": ["mcp-project-manager"]
        }
    }
}

添加 "env": {"MCP_TASK_DATA_DIR": "/path/to/your/project"} 如果你需要定制 数据目录。

🟦 克劳德桌面

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json

⚠️ Claude Desktop需要： 您必须使用指定可写目录 MCP_TASK_DATA_DIR 因为Claude Desktop在只读环境中运行。

选项1：项目特定（推荐） 将任务数据存储在项目中 文件夹：

{
    "mcpServers": {
        "pm": {
            "command": "npx",
            "args": ["mcp-project-manager"],
            "env": {
                "MCP_TASK_DATA_DIR": "/Users/yourusername/projects/my-app"
            }
        }
    }
}

选项2：共享位置 将所有任务数据存储在一个中心位置：

{
    "mcpServers": {
        "pm": {
            "command": "npx",
            "args": ["mcp-project-manager"],
            "env": {
                "MCP_TASK_DATA_DIR": "/Users/yourusername/Documents/task-management"
            }
        }
    }
}

好的目录示例：

  • 项目文件夹: /Users/yourusername/projects/my-app
  • 中心位置: /Users/yourusername/Documents/task-management
  • Windows项目: C:\\Users\\yourusername\\projects\\my-app
  • Windows中央: C:\\Users\\yourusername\\Documents\\task-management

🔵 光标

添加到光标MCP配置：

全局配置：创建 ~/.cursor/mcp.json:

{
    "mcpServers": {
        "pm": {
            "command": "npx",
            "args": ["mcp-project-manager"]
        }
    }
}

项目特定配置：创建 .cursor/mcp.json 在您的项目中：

{
    "mcpServers": {
        "pm": {
            "command": "npx",
            "args": ["mcp-project-manager"],
            "env": {
                "MCP_TASK_DATA_DIR": "/path/to/your/project"
            }
        }
    }
}

🟢 VS代码 （预览）

启用GitHub Copilot扩展和代理模式后：

工作空间配置：创建 .vscode/mcp.json 在您的项目中：

{
    "servers": {
        "pm": {
            "type": "stdio",
            "command": "npx",
            "args": ["mcp-project-manager"]
        }
    }
}

具有自定义数据目录:

{
    "servers": {
        "pm": {
            "type": "stdio",
            "command": "npx",
            "args": ["mcp-project-manager"],
            "env": {
                "MCP_TASK_DATA_DIR": "/path/to/your/project"
            }
        }
    }
}

🟡 Continue.dev

备注：MCP只能用于 代理模式 在Continue.dev中。

创建 .continue/mcpServers/pm.yaml 在您的项目中：

name: MCP Project Manager
version: 0.1.3
schema: v1
mcpServers:
    - name: Project Manager
      command: npx
      args:
          - 'mcp-project-manager'

具有自定义数据目录:

name: MCP Project Manager
version: 0.1.3
schema: v1
mcpServers:
    - name: Project Manager
      command: npx
      args:
          - 'mcp-project-manager'
      env:
          MCP_TASK_DATA_DIR: '/path/to/your/project'

🟣 其他MCP兼容工具

  • 帆板运动 -人工智能驱动的开发环境
  • 泽德 -具有AI功能的高性能代码编辑器
  • 克莱恩 -AI编码助手
  • 任何自定义MCP客户端 遵循协议

地方发展设置

如果克隆了存储库（方法2），请更新MCP客户端配置：

适用于克劳德代码/桌面 （使用内置版本）：

{
    "mcpServers": {
        "pm": {
            "command": "node",
            "args": ["/absolute/path/to/mcp-project-manager/dist/index.js"]
        }
    }
}

对于光标 （创建 ~/.cursor/mcp.json 或 .cursor/mcp.json):

{
    "mcpServers": {
        "pm": {
            "command": "node",
            "args": ["/absolute/path/to/mcp-project-manager/dist/index.js"]
        }
    }
}

VS代码 （创建 .vscode/mcp.json):

{
    "servers": {
        "pm": {
            "type": "stdio",
            "command": "node",
            "args": ["/absolute/path/to/mcp-project-manager/dist/index.js"]
        }
    }
}

对于Continue.dev （创建 .continue/mcpServers/pm.yaml):

name: MCP Project Manager
version: 0.1.3
schema: v1
mcpServers:
    - name: Project Manager
      command: node
      args:
          - '/absolute/path/to/mcp-project-manager/dist/index.js'

对于开发者

先决条件

  • Node.js 18+
  • TypeScript
  • MCP SDK知识
  • 任何与MCP兼容的开发环境

安装

git clone https://github.com/croffasia/mcp-project-manager.git
cd mcp-project-manager
npm install

发展

npm run dev    # Watch mode
npm run build  # Build for production
npm run test   # Run tests

🖥️ CLI仪表板

基于交互式终端的实时更新任务管理界面 以及分层导航。与一起跑步 npx mcp-project-manager --dashboard.

高级配置

数据库存储

数据存储在SQLite数据库中(database.sqlite)在数据目录中。

全球项目注册

MCP项目经理自动维护所有项目的全局注册表 使用它的项目。此注册表存储在：

  • MacOS/Linux： ~/.mcp-project-manager/registry.json
  • 窗户： %USERPROFILE%\.mcp-project-manager\registry.json

注册表跟踪：

  • 项目名称和绝对路径
  • 每个项目的数据库位置
  • 使用统计（上次使用，使用次数）
  • 项目创建日期

这是自动发生的，不需要配置。注册表启用 未来的功能，如项目切换和使用分析。

环境变量

  • MCP_TASK_DATA_DIR -用于存储任务数据的自定义目录
    • 必需 适用于Claude Desktop（只读环境）
    • 可选的 对于其他工具（默认为当前目录）

🌟 贡献与支持

🐛 报告问题 在我们的 GitHub问题
🤝 贡献 通过提交pull请求
📖 分享 与使用MCP兼容AI工具的其他开发人员

📄 许可证

麻省理工学院©2025 安德里·波洛斯曼

🌟 觉得这个项目有用吗？

如果MCP项目经理帮助您改进了AI驱动的开发工作流程， 请考虑给它一颗星！您的支持帮助我们接触到更多的开发人员 并继续完善该项目。

感谢您的支持！ 🙏

相关 MCP