Fastmcp Todo Server

🚀 高速MCP待办事項サーバー

このサーバーは、Swarmonomicon プロジェクト用のFastMCPベースの待办事項サーバーです。FastMCPを通じて待办事項のリクエストを受け取り、MongoDBに保存し、Swarmonomiconの待办事項処理プログラムで利用できるようにします。

✨ 主な機能

• FastMCPベースのサーバーで、待办事項のリクエストを受け取ります。
• MongoDBと統合された待办事項の保存機能があります。
• Swarmonomiconの待办事項処理プログラムと互換性があります。
• 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  # Unix/macOSシステムでの場合
   # または
   .venv\Scripts\activate  # 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
   

待办事項の追加

FastMCPを通じて待办事項を追加する方法はいくつかあります：

1. FastMCP Pythonクライアントを使用する方法：

   from fastmcp import FastMCPClient
   
   client = FastMCPClient()
   response = await client.call_tool("add_todo", {
       "description": "示例待办事项",
       "priority": "high",  # オプション、デフォルトは "medium"
       "target_agent": "user"  # オプション、デフォルトは "user"
   })
   

2. 直接MQTTを使用する方法：

   mosquitto_pub -t "mcp/todo/new" -m '{
       "description": "示例待办事项",
       "priority": "high",
       "target_agent": "user"
   }'
   

開発

1. テストを実行します：

   pytest tests/
   

2. カバレッジを含めてテストを実行します：

   pytest --cov=src tests/
   

3. 特定のテストファイルを実行します：

   pytest tests/test_todo_handler.py -v
   

📚 ドキュメント

このサーバーは、より大きな Swarmonomicon プロジェクトの一部です。このプロジェクトでは以下の機能が提供されています：

• タスクの管理と割り当て
• エージェントベースのタスク処理
• MQTTを通じたリアルタイム更新
• 複数のAIモデルとの統合

Swarmonomiconプロジェクトの詳細については、メインプロジェクトのドキュメント を参照してください。

📄 ライセンス

MITライセンス

🔧 貢献方法

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

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