Fastmcp Todo

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

FastMCP をベースにした待办事项サーバーで、Swarmonomicon プロジェクトで使用されます。このサーバーは 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 システムで
   # または Windows で
   .venv\Scripts\activate
   

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 を通じて待办事项を追加するには、以下の方法があります：

基本的な使用法

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

from fastmcp import FastMCPClient

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

高度な使用法

直接 MQTT を使用する方法：

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

開発情報

1. テストを実行する：

   pytest tests/
   

2. カバレッジ付きでテストを実行する：

   coverage run -m pytest tests/ && coverage report
   

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

   pytest tests/test_example.py -v
   

📚 ドキュメント

このサーバーは Swarmonomicon エコシステムで重要な役割を果たします。詳細情報はメインプロジェクトのドキュメントを参照してください：Swarmonomicon。

📄 ライセンス

このプロジェクトのライセンス情報はここで説明されています。詳細を取得するには、関連ファイルを参照してください。

💡 コントリビューションガイド

コミュニティの貢献を歓迎します！参加するには、プロジェクトのコントリビューションガイドを参照し、問題の提出方法、プルリクエストの方法、開発への参加方法を確認してください。