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傳輸協議集成該服務器，以獲得更好的使用體驗。同時，在設置環境變量時，可根據實際需求進行調整。