Tinysa MCP

🚀 項目 tinysa-mcp

本項目是一個MCP服務器，可通過串口操作TinySA設備。它利用多種Python庫，提供工具化接口，實現設備連接、命令執行及版本信息獲取等功能。

🚀 快速開始

該項目是一個用於通過串口操作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()

注意事項

• 切勿從後臺線程訪問Tkinter對象。
  始終使用提供的隊列和root.after進行線程安全通信。
• 此設計確保了MCP服務器和圖形界面可以併發運行，同時遵守Tkinter的線程要求。

📦 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設備的高效工具，儘管目前還在實驗階段，但未來會持續改進和優化功能。

⚠️ 重要提示

目前該項目還在進行實驗，無法保證功能正常運行。

💡 使用建議

若遇到連接問題，要確保設備正確連接且端口配置無誤；若有權限問題，可嘗試以管理員權限運行腳本或檢查設備權限設置；排查錯誤時，可使用log_monitor查看詳細日誌信息。