Fastmcp Todo

🚀 クイック MCP タスクサーバー

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

🚀 クイックスタート

このサーバーはFastMCPを通じてタスクリクエストを受け取り、MongoDBに保存します。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 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 プロジェクトの一部です。Swarmonomicon は以下の機能を提供します。

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

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

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

🔗 貢献方法

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

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