🚀 软件规划MCP服务器
本项目是 https://github.com/NightTrek/Software-planning-mcp 的 Python 修复版，旨在方便使用 SSE 接入 Cursor。该 MCP 服务器提供了软件开发规划工具，能帮助用户制定实施计划和管理待办事项。
🚀 快速开始
此 MCP 服务器可助力用户高效开展软件开发规划工作，以下为您介绍启动与配置步骤。
✨ 主要特性
- 可创建软件开发目标。
- 能制定详细的实施计划。
- 支持管理待办事项列表。
- 可跟踪任务完成状态。
- 提供结构化的思考过程。
📦 安装指南
# 克隆仓库
git clone https://github.com/Jo-Lion/software-planning-mcp.git
cd software-planning-mcp
# 创建并激活虚拟环境
python -m venv .venv
source .venv/bin/activate # Linux/Mac
# 或
.venv\Scripts\activate # Windows
# 安装依赖
pip install -e .
💻 使用示例
基础用法
启动服务器
# 使用 SSE 传输协议（推荐用于 Cursor 集成）
python server.py --debug
# 使用自定义端口
python server.py --port 9000 --debug
# 使用自定义主机地址
python server.py --host 127.0.0.1 --debug
# 使用 stdio 传输协议（用于命令行测试）
python server.py --transport stdio --debug
在 Cursor 中配置 MCP 服务器
- 打开 Cursor 编辑器。
- 进入设置 -> MCP Servers。
- 点击"Add new MCP server"。
- 输入服务器链接：
http://localhost:8000/sse（如果使用了自定义端口，请相应修改）。 - 保存配置。
高级用法
了解如何使用本项目提供的各类工具和资源，以满足不同的软件开发规划需求。
可用工具
| 工具名称 | 描述 | 参数 |
|---|---|---|
| start_planning | 开始一个新的规划会话，设置目标 | goal: 软件开发目标 |
| save_plan | 保存当前实施计划 | plan: 实施计划文本 |
| add_todo | 向当前计划添加新的待办事项 | title: 标题 description: 描述 complexity: 复杂度(0 - 10) code_example: 代码示例(可选) |
| remove_todo | 从当前计划中移除待办事项 | todo_id: 待办事项ID |
| get_todos | 获取当前计划中的所有待办事项 | 无 |
| update_todo_status | 更新待办事项的完成状态 | todo_id: 待办事项ID is_complete: 完成状态 |
可用资源
| 资源 URI | 描述 |
|---|---|
| planning://current-goal | 当前软件开发目标 |
| planning://implementation-plan | 当前实施计划及待办事项 |
环境变量
SOFTWARE_PLANNING_PORT: 设置 SSE 服务器端口号（默认：8000）。SOFTWARE_PLANNING_HOST: 设置 SSE 服务器主机地址（默认：0.0.0.0）。SOFTWARE_PLANNING_TRANSPORT: 设置传输类型，可选值为"stdio"或"sse"（默认："sse"）。SOFTWARE_PLANNING_DEBUG: 启用调试模式，可选值为"true"、"1"或"yes"（默认：禁用）。
📚 详细文档
更新说明
修复版中在执行 update_todo_status 工具时，发现 Cursor 总是会传入数字类型，但原版需要传入字符串类型，因此进行了特别修复。
📄 许可证
本项目采用 MIT 许可证。