STARWARCLOUD STARWAR.AI
返回市场
MCP项目管理器

MCP项目管理器

作者：croffasia2 星标更新：2025-07-16
安装使用来源：spider==github.com

项目介绍

🚀 MCP项目管理器

GitHub stars License Node.js MCP兼容

通过模型上下文协议（MCP）实现分层任务管理

将任何与MCP兼容的AI助手转换为强大的项目管理器，具有自动任务分解、依赖跟踪和智能工作流管理功能。

兼容工具： Claude Code • Claude Desktop • Cursor • VS Code + Copilot • 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）：

  • 在特定项目上工作
  • 想要任务数据与代码一起存放
  • 使用Cursor、VS Code或其他基于项目的工具

✅ 使用自定义目录（MCP_TASK_DATA_DIR）：

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

🚀 安装方法

方法1：NPX（推荐）

只需在您的MCP客户端配置中使用npx mcp-project-manager —— NPX会处理下载和运行服务器。

方法2：克隆仓库

为了开发或定制：

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

配置

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

支持的工具

🔷 Claude Code（推荐）

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

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

如果需要自定义数据目录，请添加"env": {"MCP_TASK_DATA_DIR": "/path/to/your/project"}。

🟦 Claude Desktop

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%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

🔵 Cursor

添加到Cursor 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 Code（预览）

启用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

注意：在Continue.dev中，MCP只能在代理模式下使用。

在您的项目中创建.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: 
schema: v1
mcpServers:
    - name: Project Manager
      command: npx
      args:
          - 'mcp-project-manager'
      env:
          MCP_TASK_DATA_DIR: '/path/to/your/project'

🟣 其他MCP兼容工具

  • Windsurf - AI驱动的开发环境
  • Zed - 具有AI特性的高性能代码编辑器
  • Cline - AI编码助手
  • 遵循协议的任何自定义MCP客户端

本地开发设置

如果您克隆了仓库（方法2），更新您的MCP客户端配置：

对于Claude Code/Desktop（使用构建版本）：

{
    "mcpServers": {
        "pm": {
            "command": "node",
            "args": ["/绝对路径/to/mcp-project-manager/dist/index.js"]
        }
    }
}

对于Cursor（创建~/.cursor/mcp.json或.cursor/mcp.json）：

{
    "mcpServers": {
        "pm": {
            "command": "node",
            "args": ["/绝对路径/to/mcp-project-manager/dist/index.js"]
        }
    }
}

对于VS Code（创建.vscode/mcp.json）：

{
    "servers": {
        "pm": {
            "type": "stdio",
            "command": "node",
            "args": ["/绝对路径/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:
          - '/绝对路径/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    # 监视模式
npm run build  # 构建生产版本
npm run test   # 运行测试

🖥️ CLI仪表板

交互式的终端界面，用于任务管理，具有实时更新和分层导航。使用npx mcp-project-manager --dashboard运行。

高级配置

数据库存储

数据存储在SQLite数据库（database.sqlite）中，位于数据目录内。

全局项目注册表

MCP项目管理器自动维护一个全局注册表，记录其使用的所有项目。该注册表存储在：

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

注册表跟踪：

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

这会自动发生——无需配置。注册表使未来功能如项目切换和使用分析成为可能。

环境变量

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

🌟 贡献和支持

🐛 报告问题 在我们的 GitHub Issues
🤝 贡献 通过提交拉取请求
📖 分享 给其他使用MCP兼容AI工具的开发者

📄 许可证

MIT © 2025 Andrii Poluosmak

🌟 发现这个项目有用吗？

如果MCP项目管理器帮助改善了您的AI驱动的开发工作流程，请考虑给它一个星！您的支持有助于我们接触更多开发者并继续改进项目。

GitHub stars

感谢您的支持！ 🙏