Omnispindle

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

このサーバーは、FastMCPをベースにしたTodoサーバーで、Swarmonomicon プロジェクトで使用されます。FastMCPを通じてtodoリクエストを受け取り、そのリクエストをMongoDBに保存し、Swarmonomicon todoワーカーが処理できるようにします。

✨ 主な機能

• FastMCPベースのサーバーで、todoリクエストを受け取る
• MongoDBを統合してtodoを保存する
• 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  # 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
   

Todoの追加

FastMCPを使ってtodoを追加する方法はいくつかあります：

1. FastMCP Pythonクライアントを使う：

   from fastmcp import FastMCPClient
   
   client = FastMCPClient()
   response = await client.call_tool("add_todo", {
       "description": "Example todo",
       "priority": "high",  # オプション、デフォルトは "medium"
       "target_agent": "user"  # オプション、デフォルトは "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 プロジェクトの一部です。このプロジェクトは以下の機能を提供します：

• タスク管理と割り当て
• エージェントベースのタスク処理
• リアルタイムMQTT更新
• 様々なAIモデルの統合

Swarmonomiconプロジェクトとその機能に関する詳細情報は、メインプロジェクトのドキュメント を参照してください。

📄 ライセンス

MITライセンス

🔧 貢献ガイド

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

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