Software Planning MCP

🚀 软件规划MCP服务器

这是一个基于Python的修复版软件开发规划MCP服务器，支持通过SSE协议接入Cursor。它提供了一套工具和功能，可帮助用户进行软件开发目标设定、实施计划制定以及待办事项管理。

🚀 快速开始

安装

# 克隆仓库
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上运行
# 或者在Windows上运行
.venv\Scripts\activate 

# 安装依赖
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服务器

1. 打开Cursor编辑器。
2. 进入设置 -> MCP Servers。
3. 点击"Add new MCP server"。
4. 输入服务器链接：http://localhost:8000/sse（如果使用了自定义端口，请相应修改）。
5. 保存配置。

✨ 主要特性

• 创建软件开发目标：用户可以定义明确的软件开发目标。
• 制定详细实施计划：提供结构化的方式来规划项目的具体步骤。
• 管理待办事项列表：支持添加、更新和跟踪待办事项的状态。
• 跟踪任务完成状态：能够实时查看每个任务的完成情况。
• 提供结构化的思考过程：帮助用户以系统化的方式进行项目规划。

💻 使用示例

基础用法

# 使用start_planning工具
response = client.start_planning(goal="开发一个简单的待办事项管理器")

# 使用save_plan工具
response = client.save_plan(plan="第一阶段：需求分析；第二阶段：设计；第三阶段：实现；第四阶段：测试和优化")

# 使用add_todo工具
response = client.add_todo(
    title="完成项目文档",
    description="编写用户手册和技术文档",
    complexity=2,
    code_example="example_code()"
)

# 使用remove_todo工具
response = client.remove_todo(todo_id="12345")

# 使用get_todos工具
todos = client.get_todos()

# 使用update_todo_status工具
response = client.update_todo_status(
    todo_id="12345",
    is_complete=True  # 或者传入字符串"True"
)

📚 详细文档

可用工具

可用资源

环境变量

🔧 技术细节

类型转换

在修复版中，工具接口会对输入参数进行必要的类型转换。例如，对于update_todo_status工具，is_complete参数可以是布尔值或其对应的字符串形式（如"True"或"False"）。

错误处理

如果传入的参数格式不符合要求，服务器会返回相应的错误信息，并建议如何修正。

📄 许可证

本项目文档更新修复了之前版本中类型不匹配的问题，现在支持将布尔值和其对应的字符串形式传递给update_todo_status工具。

⚠️ 重要提示

在使用该服务器时，要注意工具接口的类型转换以及参数格式要求，若参数格式不符合要求，服务器会返回错误信息并给出修正建议。

💡 使用建议

建议在Cursor中使用SSE传输协议集成该服务器，以获得更好的使用体验。同时，在设置环境变量时，可根据实际需求进行调整。