Serial MCP Server

🚀 シリアルMCPサーバ

シリアルポート通信向けの専用モデルコンテキストプロトコル（MCP）サーバです。組み込みシステム、IoTデバイス、ハードウェアデバッグにおいて、AIアシスタントに総合的なシリアル通信機能を提供し、実際のハードウェアとの統合を実現します。

📖 言語バージョン: English | 中文

✨ 主な機能

• 🚀 本番環境対応: 5つの総合的なシリアル通信ツールを備え、実際のハードウェアとの統合が可能です。
• 🔌 クロスプラットフォーム対応: Windows、Linux、macOSをサポートし、自動ポート検出機能付きです。
• 📡 完全なシリアル制御: ポートの一覧表示、接続、データの送受信を完全に設定可能です。
• 📝 複数のデータ形式: UTF - 8、16進数、バイナリエンコーディングをサポートし、タイムアウト処理も可能です。
• 🛠️ ハードウェア統合: STM32、Arduino、ESP32などの組み込みシステムでテスト済みです。
• 🤖 AI統合: ClaudeなどのAIアシスタントと完全に互換性があります。
• 🧪 総合的なテスト: すべての5つのツールが実際のハードウェアで検証されています。
• ⚡ 高性能: Tokio非同期ランタイムに基づいて構築され、同時接続をサポートしています。

🏗️ アーキテクチャ

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP Client    │◄──►│  Serial MCP      │◄──►│  Serial Device  │
│   (Claude/AI)   │    │  Server          │    │  Hardware       │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │  Target Device   │
                       │  (STM32/Arduino) │
                       └──────────────────┘

🚀 クイックスタート

前提条件

ハードウェア要件:

• シリアルデバイス: STM32、Arduino、ESP32、またはUART互換のデバイス
• 接続: USB - シリアルコンバータまたは内蔵USB - UART
• USBケーブル: デバイスをPCに接続するため

ソフトウェア要件:

• Rust 1.70以上
• シリアルデバイスドライバ（ほとんどのシステムで自動検出）

インストール

# ソースからクローンしてビルド
git clone https://github.com/adancurusul/serial-mcp-server.git
cd serial-mcp-server
cargo build --release

基本的な使用法

MCPクライアントの設定

Claudeデスクトップの設定例

Claudeデスクトップの設定ファイルに追加します。

Windowsの例:

{
  "mcpServers": {
    "serial": {
      "command": "C:\\path\\to\\serial-mcp-server\\target\\release\\serial-mcp-server.exe",
      "args": [],
      "env": {
        "RUST_LOG": "info"
      }
    }
  }
}

macOS/Linuxの例:

{
  "mcpServers": {
    "serial": {
      "command": "/path/to/serial-mcp-server/target/release/serial-mcp-server",
      "args": [],
      "env": {
        "RUST_LOG": "info"
      }
    }
  }
}

cursor、claude codeなどの他のツールの例については、対応するツールのドキュメントを参照してください。

🎯 STM32デモの試し方

当社では、すべての機能を紹介する包括的な STM32シリアル通信デモ を提供しています。

# サンプルディレクトリに移動
cd examples/STM32_demo

# ファームウェアをビルドして実行
cargo run --release

# MCPサーバと一緒に使用して、完全なシリアル通信体験を楽しみましょう

デモの内容:

• ✅ 対話型シリアルコマンド: コマンドを送信し、リアルタイムで応答を取得します。
• ✅ すべての5つのMCPツール: 実際のSTM32ハードウェアで完全に検証されています。
• ✅ ハードウェア制御: LEDの切り替え、カウンターシステム、点滅パターン
• ✅ コマンドインターフェース: 対話型コマンド処理を備えたヘルプシステム

📖 STM32デモのドキュメントを表示 →

AIアシスタントとの使用例

利用可能なシリアルポートの一覧表示

システム上の利用可能なシリアルポートを一覧表示してください

シリアルデバイスに接続

私のSTM32デバイスを、ボーレート115200でCOM19に接続してください

対話型コマンドの送信

ヘルプメニューを取得するために'H'コマンドを送信し、次にLEDを切り替えるために'L'を送信してください

デバイスの応答を読み取る

2秒のタイムアウトでシリアルデバイスからの応答を読み取ってください

完全な通信テスト

COM19の私のSTM32ボードですべての5つのMCPシリアルツールをテストしてください。まずポートを一覧表示し、次に接続し、いくつかのコマンドを送信し、応答を読み取り、最後に接続を閉じてください。

🛠️ 完全なツールセット（5つのツール）

すべてのツールは、実際のSTM32ハードウェアでテストおよび検証されています。

📡 シリアル通信（5つのツール）

✅ 5つのツールすべて - 実際のハードウェアで100%成功率

🌍 サポートされるハードウェア

シリアルデバイス

• STM32: UART機能を備えたすべてのSTM32シリーズ
• Arduino: Uno、Nano、ESP32、ESP8266
• 組み込みシステム: UART/USB - シリアルインターフェースを備えた任意のデバイス
• 産業用: Modbus、RS485コンバータ
• IoTデバイス: シリアル通信を備えたセンサー、アクチュエーター
• その他: UART/USB - シリアルインターフェースを備えた任意のデバイス

シリアルインターフェース

• USB - シリアル: CH340、CH343、FTDI、CP2102
• 内蔵USB: USB - CDCを備えたSTM32、Arduino Leonardo
• ハードウェアUART: 直接UART接続

プラットフォームサポート

🏆 本番環境での状態

✅ 完全に実装され、テスト済み

現在の状態: 本番環境対応

• ✅ 完全なシリアル統合: すべての5つのツールで実際のハードウェアとの通信が可能です。
• ✅ ハードウェア検証: COM19のSTM32 + CH343 USB - シリアルでテスト済みです。
• ✅ 対話型通信: 完全な双方向コマンド/応答システム
• ✅ マルチプラットフォーム: Windows、Linux、macOSを自動検出でサポートしています。
• ✅ 接続管理: 適切なクリーンアップを伴う堅牢な接続処理
• ✅ AI統合: MCPプロトコルと完全に互換性があります。

📦 技術的特徴

シリアル実装

• クロスプラットフォーム: 自動ポート検出と設定
• 複数のエンコーディング: UTF - 8、16進数、バイナリデータをサポート
• タイムアウト処理: 読み取り/書き込みタイムアウトを設定可能
• 接続プーリング: 複数の同時シリアル接続をサポート

パフォーマンス特性

• ポート検出: 利用可能なポートを高速で列挙
• 接続速度: 迅速な接続確立
• データスループット: 最小限の遅延で効率的なデータ転送
• セッション安定性: 長時間の動作期間でテスト済み

🙏 謝辞

以下のオープンソースプロジェクトに感謝します。

• serialport-rs - シリアルポート通信ライブラリ
• rmcp - Rust MCP SDK
• tokio - 非同期ランタイム

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

⭐ このプロジェクトが役に立った場合は、スターを付けていただけると幸いです！