FastMCP Todoサーバー

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

特徴

• ToDoリクエストを受信するためのFastMCPサーバー

• ToDo ストレージ用の MongoDB 統合

• Swarmonomicon ToDoワーカーと互換性あり

• Pythonベースの実装

インストール

1. リポジトリをクローンします。

   git clone https://github.com/DanEdens/Omnispindle.git cd Omnispindle

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.Omnispindle

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 プロジェクトへの貢献に関する詳細については、 メイン プロジェクトの貢献ガイドラインを参照してください。