MCP Arduino Server

🚀 MCP Arduino サーバー（mcp-arduino-server）

このツールは FastMCP をベースとしたブリッジツールで、Model Context Protocol (MCP) を通じて arduino-cli の機能を公開します。コードスケッチ、ボード、ライブラリファイル、ファイルの管理や、WireViz 回路図の生成（YAML または自然言語入力から）を行うことができます。

🚀 クイックスタート

mcp-arduino-server

サーバーは STDIO 上の JSON-RPC MCP 呼び出しを待ち受けます。主要なメソッドは以下の通りです。

Sketches（コードスケッチ）

• create_new_sketch(name) 新しいスケッチを作成します。
• list_sketches() すべてのスケッチをリストします。
• read_file(path) ファイルの内容を読み取ります。
• write_file(path, content[, board_fqbn]) (自動的に .ino をコンパイルして開きます)

ビルドとデプロイ

• verify_code(sketch, board_fqbn) コードを検証します。
• upload_sketch(sketch, port, board_fqbn) スケッチをアップロードします。

ライブラリファイル

• lib_search(name[, limit]) ライブラリファイルを検索します。
• lib_install(name) ライブラリファイルをインストールします。
• list_library_examples(name) ライブラリのサンプルをリストします。

ボード

• list_boards() すべてのボードをリストします。
• board_search(query) ボードを検索します。

ファイル操作

• rename_file(src, dest) ファイルをリネームします。
• remove_file(path) (破壊的な操作；ホームディレクトリとスケッチディレクトリに限定)

WireViz 回路図

• generate_circuit_diagram_from_description(desc, sketch="", output_base="circuit") (AI 対応；OPENAI_API_KEY が必要で、PNG ファイルを自動的に開きます)

✨ 主な機能

• Model Context Protocol (MCP) を通じて arduino-cli の機能を公開する。
• コードスケッチ、ボード、ライブラリファイル、ファイルの管理を行う。
• WireViz 回路図を YAML または自然言語入力から生成する。

📦 インストール

PyPI からのインストール

pip install mcp-arduino-server

ソースコードからのインストール

git clone https://github.com/Volt23/mcp-arduino-server.git
cd mcp-arduino-server
pip install .

📚 ドキュメント

必要条件

• Python ≥3.10
• arduino-cli が PATH で利用可能であること
• MCP SDK (mcp[cli])
• WireViz（オプション；回路図生成用）
• OPENAI_API_KEY（AI 対応の WireViz を使用する場合は OpenAI API キーが必須）
• thefuzz[speedup]（オプション；曖昧なローカルライブラリ検索を有効にする）

設定

環境変数を使用すると、デフォルト値を上書きできます。

MCP クライアントの設定

MCP クライアント（Claude Desktop など）と統合するには、環境変数に OpenAI API キーを設定します。

{
  "mcpServers": {
    "arduino": {
      "command": "/path/to/mcp-arduino-server",
      "args": [],
      "env": {
        "WIREVIZ_PATH": "/path/to/wireviz",
        "OPENAI_API_KEY": "<your-openai-api-key>"
      }
    }
  }
}

トラブルシューティング

• LOG_LEVEL=DEBUG を設定して詳細なログを有効にします。
• ファイルとシリアルポートの権限を確認します。
• 問題が発生した場合は、プロジェクトのドキュメントまたはコミュニティサポートを参照してください。

📄 ライセンス

MIT License