FastMCP Todoサーバー

Swarmonomiconプロジェクト用のFastMCPベースのTodoサーバー。このサーバーはFastMCP経由でTodoリクエストを受信し、MongoDBに保存してSwarmonomicon Todoワーカーで処理します。

特徴

• ToDoリクエストを受信するためのFastMCPサーバー
• ToDo ストレージ用の MongoDB 統合
• Swarmonomicon ToDoワーカーと互換性あり
• Pythonベースの実装

インストール

1. リポジトリをクローンします。
   git clone https://github.com/DanEdens/fastmcp-todo-server.git cd fastmcp-todo-server
2. uv をインストールします (まだインストールされていない場合)。
   curl -LsSf https://astral.sh/uv/install.sh | sh
3. uv を使用して仮想環境を作成し、アクティブ化します。
   uv venv source .venv/bin/activate # On Unix/macOS # or .venv\Scripts\activate # On Windows
4. uv を使用して依存関係をインストールします。
   uv pip install -r requirements.txt
5. 開発の場合は、追加の依存関係をインストールします。
   uv pip install -r requirements-dev.txt
6. 設定を含む.envファイルを作成します。
   MONGODB_URI=mongodb://localhost:27017 MONGODB_DB=swarmonomicon MONGODB_COLLECTION=todos

使用法

サーバーの起動

1. FastMCP サーバーを起動します。
   python -m src.fastmcp_todo_server

ToDoの追加

FastMCP を使用して ToDo を追加するには、いくつかの方法があります。

1. FastMCP Python クライアントの使用:
   from fastmcp import FastMCPClient client = FastMCPClient() response = await client.call_tool("add_todo", { "description": "Example todo", "priority": "high", # optional, defaults to "medium" "target_agent": "user" # optional, defaults to "user" })
2. MQTT を直接使用する:
   mosquitto_pub -t "mcp/todo/new" -m '{ "description": "Example todo", "priority": "high", "target_agent": "user" }'

発達

1. テストを実行します:
   pytest tests/
2. カバレッジ付きのテストを実行します。
   pytest --cov=src tests/
3. 特定のテスト ファイルを実行します。
   pytest tests/test_todo_handler.py -v

Swarmonomiconとの統合

このサーバーは、以下を提供する大規模なSwarmonomiconプロジェクトの一部です。

• タスク管理と配布
• エージェントベースのタスク処理
• MQTTによるリアルタイム更新
• さまざまなAIモデルとの統合

Swarmonomicon プロジェクトとその機能の詳細については、 メインのプロジェクト ドキュメントをご覧ください。

ライセンス

MITライセンス

貢献

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. 新しい機能のテストを追加する
5. プルリクエストを送信する

Swarmonomicon プロジェクトへの貢献に関する詳細については、 メイン プロジェクトの貢献ガイドラインを参照してください。