MCP Cobot Server

MCP Cobot Server

このリポジトリには、M5 MyCobot280 ロボット向けの FastMCP サーバー実装である MCP Cobot Server が含まれています。

model context protocol python-sdk に基づいています：https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#quickstart

特長

• 効率的なコンテキスト管理のための MCP 標準を実装しています。
• 高いパフォーマンスと拡張性を実現するため、FastMCP で構築されています。
• 協働ロボット（myCobot）システムとの統合を目的に設計されています。

要件

• Python 3.8+
• FastMCP ライブラリ

インストール

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

   git clone https://github.com/your-username/mcp-cobot-server.git
   cd mcp-cobot-server
   

2. 依存関係をインストールします：

   uv sync
   source .venv/bin/activate
   

注記 このプロジェクトでは、Python の仮想環境と依存関係のインストールおよび管理に uv を使用しています。詳しくはこちらをご覧ください：https://docs.astral.sh/uv/guides/projects/

使い方

サーバーを起動します：

# launch a standalone MCP server with:
uvx mcpo --port 8000 -- uv run --with mcp[cli] --with pymycobot mcp run ./server.py

# Install the mcp profile with claude
mcp install server.py

開発時：

# debug the mcp interface
mcp dev server.py

利用可能な関数

server.py の mcp.tool に、次の関数が公開されています：

1. get_angles：すべてのサーボの現在の角度を取得します。
2. move_angle：指定した速度で、特定の関節（サーボ）を目標角度まで動かします。
3. move_angles：指定した速度で、すべての関節を指定角度まで動かします。
4. go_home：すべての関節をあらかじめ設定された「ホーム」位置まで動かします。
5. set_home：現在の関節角度を新しい「ホーム」位置として設定します。
6. change_color：ロボットの LED マトリクスの色を変更します。
7. relax：すべてのサーボを解放し、ロボットアームを脱力させます。
8. interpretive_dance_routine：説明に基づいて、関節の動きと LED の色変更を伴う創作ダンスを実行します。

MyCobot M5 280

使用している myCobot SDK のドキュメントはこちらです：https://github.com/elephantrobotics/pymycobot/blob/main/docs/MyCobot_280_en.md 使用しているロボットはこちらです：Elephant Robotics myCobot 280 M5Stack 2023 - 6 DOF Collaborative Robot

関節の範囲

関節 ID	範囲
1	-168 ~ 168
2	-135 ~ 135
3	-150 ~ 150
4	-145 ~ 145
5	-165 ~ 165
6	-180 ~ 180

貢献

貢献を歓迎します！イシューを作成するか、プルリクエストを送信してください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳しくは LICENSE ファイルをご覧ください。