MCP计划服务器
用于Claude Code的MCP服务器，帮助组织和跟踪软件开发任务。
这是什么？
这是Claude Code（Anthropic的AI编码助手）的插件。它增加了规划工具，有助于：
- 将复杂任务分解为步骤
- 跟踪已完成的工作和下一步的工作
- 记录技术决策
- 比较不同的解决方案
先决条件
安装前，请确保：
- Node.js （版本18或更高）-从下载https://nodejs.org
- 克劳德代码 -Anthropic的CLI工具
要检查是否安装了Node.js，请在终端中运行：
node --version安装
- 克隆或下载此存储库
- 在项目文件夹中打开终端
- 安装依赖项：
npm install- 构建项目：
npm run build构建后，您应该看到 dist 包含编译文件的文件夹。
配置
要将此服务器与Claude Code一起使用，您需要将其添加到MCP设置中。
第一步：查找您的设置文件
设置可以放置在以下位置之一：
| 位置 | 文件路径 | 用例 |
|---|---|---|
| 项目（私人） | .claude/settings.local.json | 只为你，不共享 |
| 项目（共享） | .claude/settings.json | 通过git与团队共享 |
| 全球 | ~/.claude/settings.json | 您的所有项目 |
步骤2：添加服务器配置
打开或创建设置文件并添加：
{
"mcpServers": {
"planning": {
"command": "node",
"args": ["FULL_PATH_TO/planner/dist/index.js"],
"env": {
"MCP_PLANNING_STORAGE_PATH": "./.mcp-plans"
}
}
}
}重要提示： 替换 FULL_PATH_TO 此文件夹的实际路径。
示例路径：
- 窗户：
D:/Projects/planner/dist/index.js - Mac/Linux：
/home/user/projects/planner/dist/index.js
步骤3（可选）：允许工具无需确认
默认情况下，Claude Code会请求每次使用工具的权限。要跳过计划工具的确认，请将此部分添加到您的设置文件中：
{
"permissions": {
"allow": [
"mcp__planning"
]
}
}您的完整设置文件如下：
{
"mcpServers": {
"planning": {
"command": "node",
"args": ["FULL_PATH_TO/planner/dist/index.js"],
"env": {
"MCP_PLANNING_STORAGE_PATH": "./.mcp-plans"
}
}
},
"permissions": {
"allow": [
"mcp__planning"
]
}
}注： 准确使用 mcp__planning （不是 mcp__planning__*).不支持通配符。
如何使用
配置后，只需自然地与Claude Code交谈即可。
开始新计划
告诉Claude Code你想构建什么：
“我需要构建一个用户登录系统”
Claude Code将自动：
- 制定计划
- 添加要求
- 建议解决方案
- 将工作分为几个阶段
检查进度
向Claude Code询问您的计划：
“我的计划进展如何？” “我接下来应该做什么？”
更新进度
当你完成某事时，告诉克劳德代码：
“我完成了登录表单”
Claude Code将更新计划并建议下一步做什么。
可用工具
服务器提供8类工具：
| 类别 | 描述 |
|---|---|
| 计划 | 创建和管理计划 |
| 需求 | 定义需要构建的内容 |
| 解决方案 | 比较不同的方法 |
| 决策 | 记录技术选择 |
| 阶段 | 将工作分解为步骤 |
| 链接 | 连接相关项目 |
| 查询 | 搜索和分析计划 |
| 工件 | 存储代码和配置 |
计划存储位置
计划保存为JSON文件：
.mcp-plans/
plans/
{plan-id}/
manifest.json
requirements.json
solutions.json
decisions.json
phases.json
links.json
artifacts.json
active-plans.json故障排除
Claude Code看不到规划工具
- 检查设置中的路径是否正确
- 确保你跑了
npm run build - 更改设置后重新启动Claude Code
权限错误
- 检查存储路径是否可写
- 在Windows上，如果可能的话，避免使用带空格的路径
许可证
麻省理工学院