XTELL Serial

xtell-serial

XTELL について（www.xtell.cn）

Shenzhen XTELL Future Technology は、ソフトウェア、回路設計、金型開発、量産をすべて一つのチームで手がけ、真のフルスタック開発を提供しています。組み込みソフトウェアとハードウェア、クラウドプラットフォームとバックエンド、AI アルゴリズム、IoT ソリューション、モバイルインターネット技術まで、幅広い分野に取り組んでいます。コンセプト設計から量産納品まで、製品開発の全工程をサポートします。ハードウェアとソフトウェアの緊密な連携により、お客様の製品の市場投入を迅速化し、商業的な成功を支援します。

AI アシスタントが MCP 経由で操作できる、GUI 付きのシリアルターミナルです。 通常のデスクトップウィンドウでログが流れる様子を確認でき、Claude、Cursor、その他の MCP クライアントは同じログを読み取り、同じポートにコマンドを送信できます。

ステータス：早期プレビュー（v0.1）。現在は Windows のみ対応しています。MCP の詳しいセットアップガイドとツールのリファレンスは、docs/MCP_SETUP.md（中国語版もあります）をご覧ください。

中国語の説明

上部のペインにログが表示され、フィルター（ここでは ERR）に一致する箇所が強調表示され、下部に一覧表示されます。ログはデモデータです。

概要

• 本格的なシリアルターミナルです。最大 10 Mbaud のボーレート、UTF-8／GBK／GB2312／ASCII、HEX 表示と送信、タイムスタンプ、行番号に対応しています。
• 部分文字列または正規表現でリアルタイムにフィルタリングでき、一致箇所の強調表示と、フィルター適用後の個別ビューに対応しています。
• 繰り返し送信、送信履歴、追記モードでのファイル保存、使用状況バー付きの 100,000 行バッファを備えています。
• 英語と中国語のユーザーインターフェースに対応しています。メニューバーの「File」の隣にある言語項目（ENG／中文）から切り替えられます。選択した言語は記憶されます（初回起動時は Windows の表示言語に従います）。
• 複数のウィンドウを同時に開け、それぞれに名前を付けられます。複数のボードを使うベンチ環境に便利です。最初のウィンドウがローカルハブとして機能し、閉じると別のウィンドウが引き継ぎます。
• AI クライアントに 14 個のツールを提供する MCP サーバー（xtell-serial-mcp）を備えています。ポートの一覧表示、接続、送信、自動送信、受信／送信／フィルタリング済みデータの読み取り（時間範囲の指定も可能）、フィルター設定、ファイル保存、バッファのクリア、バッファ状態の確認に対応しています。

GUI と MCP サーバーは、127.0.0.1:50016 のローカル TCP ハブを介して通信します（XTELL_SERIAL_HUB_PORT で変更可能）。パブリックインターフェースで待ち受けることはありません。

スクリーンショット

ソースから実行する

pip install -r requirements.txt
python xtell_serial.py

実行ファイルをビルドする（Windows）

pip install pyinstaller
build_exe.bat

これにより、dist\xtell-serial.exe（GUI）と dist\xtell-serial-mcp.exe（MCP サーバー）が生成されます。

AI クライアントを接続する

MCP サーバーとして xtell-serial-mcp.exe（GUI ではありません）を登録します。Claude Code の場合：

claude mcp add xtell-serial C:\path\to\xtell-serial-mcp.exe

Claude Desktop、Cursor などの場合は、クライアントの MCP 設定に次の内容を追加します（mcp_config.example.json を参照してください）。

{
  "mcpServers": {
    "xtell-serial": {
      "command": "C:\\path\\to\\xtell-serial-mcp.exe",
      "args": []
    }
  }
}

ツールの詳しいリファレンスは docs/MCP_SETUP.md をご覧ください。

次のようにアシスタントに依頼してみてください：「COM3 に 115200 で接続して、AT+GMR を送信し、モジュールが報告するバージョンを教えてください。」

安全上の注意

• アシスタントは、ポートに接続されたデバイスに任意のバイトを送信できます。予期しないコマンドが危害を引き起こす可能性のあるハードウェアには接続しないでください。
• ローカルハブが受け付ける接続は 127.0.0.1 からのものに限られます。

ライセンス

Apache License 2.0。詳細は LICENSE をご覧ください。

---

深圳の組み込みハードウェア・ソフトウェア設計会社である XTELL が開発しました。