Interactive Draw MCP

🚀 交互式繪製 MCP

此項目是一個模型上下文協議（MCP）服務器示例，帶有交互式繪圖界面。它展示瞭如何構建一個包含單獨繪圖界面的MCP擴展，使用Tkinter作為圖形接口，為用戶提供了便捷的繪圖體驗。

🚀 快速開始

作為獨立MCP服務器

運行服務器以打開繪圖窗口：

interactive-draw-mcp

與Goose集成

方案1：使用Goose CLI（推薦）

啟用擴展啟動Goose會話：

# 本地開發
goose session --with-extension "python -m interactive-draw-mcp"

✨ 主要特性

• 繪製網格界面：

  • 提供一個16x16網格，每個單元格可以切換為兩種狀態（填充或空白）。
  • 提供一個清空網格按鈕，重置所有單元格。

• 服務器功能：

  • 啟動繪圖會話：初始化新會話並打開界面。
  • 切換單元格顏色：通過命令接口切換指定row和col位置的單元格顏色。
  • 獲取網格狀態：返回當前網格配置的文本表示。

• 持久化存儲：網格狀態保存到JSON文件（board_state.json），以保持不同會話之間的一致性。

• UI和狀態同步：

  • 即時UI更新：一個後臺線程持續監視網格狀態文件，將更改反映在界面中。

📦 安裝指南

方案1：從源代碼安裝

1. 克隆此倉庫：

   git clone https://github.com/AaronGoldsmith/interactive_draw_mcp
   cd interactive_draw_mcp
   

2. 安裝包：

   pip install -e .
   

📚 詳細文檔

工具和架構概述

• 服務器工具：
  • start_drawing_session()：初始化繪圖會話並打開界面。
  • toggle_cell_color(row, col)：切換指定row和col位置的單元格顏色。
  • get_grid_state()：返回網格當前狀態的字符串表示。

資源與參考資料

• 靈感來源：此MCP受到Kvadratni/tik-tak-toe-mcp的啟發。

架構概述

該項目架構展示了：

1. MCP服務器：通過明確定義的工具管理Goose AI與繪圖界面之間的通信。
2. 交互式UI：提供網格的可視化界面。
3. 與Goose AI集成：來自Goose AI的工具調用直接反映到網格狀態，反之亦然。

優勢

• 職責分離：在邏輯和呈現之間保持清晰的劃分。
• 改進用戶體驗：提供直觀的視覺反饋，同時保留基於文本的命令界面。
• 適應性：可以擴展為更復雜的應用程序，涉及AI與交互式界面。