Tinysa MCP

🚀 プロジェクト tinysa - mcp

シリアルポートを介してTinySAデバイスを操作するMCPサーバーです。

⚠️ 重要提示

現在、このプロジェクトは実験段階であり、機能の正常動作を保証することはできません。

🚀 クイックスタート

このプロジェクトは、シリアルポートを介してTinySAデバイスを操作するためのMCPサーバーです。pyserial、httpx、numpy、Pillow、FastMCPなどのPythonライブラリを利用し、デバイスの接続、コマンドの実行、デバイスのバージョン情報の取得などの操作を行うためのツールベースのインターフェースを提供します。

✨ 主な機能

• デバイスにコマンドを送信し、応答を取得します。
• ファームウェアとハードウェアのバージョン情報を取得します。
• MCPツールを提供し、他のシステムとの統合をサポートします。
• デバイスの画面画像をキャプチャし、必要に応じてタイムスタンプ付きでファイルに保存します。

🔧 技術詳細

アーキテクチャとスレッドモデル

このプロジェクトでは、TkinterグラフィカルインターフェースとMCPサーバーの両方を使用しています。Tkinterはメインスレッドで実行する必要があるため、以下のような設計になっています。

flowchart TD
    subgraph MainThread
        A[main()] --> B[tk.Tk() & TinySALogMonitor]
        B --> C[root.mainloop()]
    end
    subgraph MCPThread
        D[run_mcp_server(mcp_server)]
        D --> E[mcp_server.run()]
    end
    E -- log_callback --> F[log_monitor.log_queue]
    F -- root.afterで定期ポーリング --> B
    D -- サーバー終了時 --> G[root.after(0, root.destroy)]

• Tkinterグラフィカルインターフェースはメインスレッドで実行：
  メインスレッドでTkinterのルートウィンドウを初期化し、メインイベントループを開始します。すべてのグラフィカルインターフェース操作はこのスレッドで実行されます。

• MCPサーバーはバックグラウンドスレッドで実行：
  MCPサーバーはPythonのthreading.Threadを使用して別のスレッドで起動されます。これにより、サーバーはリクエストを処理しながらグラフィカルインターフェースと並行して実行できます。

• キューを使用したスレッド間通信：
  ログメッセージやその他のデータは、MCPサーバー（または他のバックグラウンドスレッド）からqueue.Queueを介してグラフィカルインターフェースに送信されます。グラフィカルインターフェースはroot.afterを使用してこのキューを定期的にポーリングし、表示内容を安全に更新します。

• エレガントな終了：
  MCPサーバーが停止すると、root.after(0, root.destroy)を使用してグラフィカルインターフェースの終了をスケジュールし、すべてのTkinter操作がメインスレッドで実行されることを保証します。

例（メイン関数）：

def main():
    root = tk.Tk()
    log_monitor = TinySALogMonitor(root)
    mcp_server = create_mcp_server(log_monitor.add_log)
    mcp_thread = threading.Thread(target=run_mcp_server, args=(mcp_server,), daemon=True)
    mcp_thread.start()
    root.mainloop()

MCPツール

以下のMCPツールが利用可能です。

• get_version：TinySAデバイスからバージョン情報を取得します。
• execute_command：TinySAデバイスにコマンドを送信し、応答を取得します。
• connect：指定されたポートでTinySAデバイスに接続します。
• disconnect：TinySAデバイスとの接続を切断します。
• get_device_info：接続されたデバイスの詳細情報を取得します。
• capture_image：TinySAの画面画像をキャプチャし、必要に応じてタイムスタンプ付きでファイルに保存します。

💻 使用例

基本的な使用法

# 示例代码：
print("设备版本：", get_version())
print("执行命令结果：", execute_command("command"))
connect(port)
获取设备信息()
captured_image = capture_image()

📚 ドキュメント

トラブルシューティング

1. 接続問題：デバイスが正しく接続されていること、ポート設定が正しいことを確認してください。
2. 権限問題：スクリプトを管理者権限で実行するか、デバイスの権限設定を確認してください。
3. ログ記録：log_monitorを使用して詳細なログ情報を確認し、エラーを特定してください。

参考資料

• pyserial 文档
• FastMCP 项目页面

📄 ライセンス

[许可证内容]

このプロジェクトは、TinySAデバイスを操作するための効率的なツールを提供することを目的としています。現在は実験段階ですが、将来的に機能の改善と最適化が行われます。