Software Planning MCP

🚀 ソフトウェアプランニングMCPサーバー

Pythonベースの修正版ソフトウェア開発プランニングMCPサーバーで、SSEプロトコルを通じてCursorに接続できます。

このMCPサーバーは、ユーザーがソフトウェア開発の目標設定、実施計画の策定、タスク管理を行うためのツールと機能を提供します。

🚀 クイックスタート

このソフトウェアプランニングMCPサーバーは、Pythonベースで構築されており、SSEプロトコルを通じてCursorに接続できます。以下の手順でサーバーを起動し、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"を渡す
)

📚 ドキュメント

利用可能なツール

利用可能なリソース

環境変数

• SOFTWARE_PLANNING_PORT: SSEサーバーのポート番号を設定します（デフォルト: 8000）。
• SOFTWARE_PLANNING_HOST: SSEサーバーのホストアドレスを設定します（デフォルト: 0.0.0.0）。
• SOFTWARE_PLANNING_TRANSPORT: 伝送プロトコルを設定します（デフォルト: sse、選択可能な値はsseまたはstdio）。

注意事項

⚠️ 重要提示

1. 型変換: 修正版では、ツールのインターフェイスが入力パラメータに必要な型変換を行います。例えば、update_todo_statusツールのis_completeパラメータは、ブール値またはそれに対応する文字列形式（"True"または"False"）で指定できます。
2. エラー処理: 入力されたパラメータの形式が要件に合わない場合、サーバーは適切なエラーメッセージを返し、修正方法を提案します。

ドキュメントの更新

以前のバージョンでの型不整合の問題を修正し、update_todo_statusツールにブール値とそれに対応する文字列形式を渡すことができるようになりました。

📄 ライセンス