交互式绘图 MCP

本项目是一个带有交互式绘图界面的模型上下文协议 (MCP) 服务器示例。它演示了如何构建一个 MCP 扩展，该扩展包含一个独立的 UI 窗口用于绘图，并使用 Tkinter 作为图形界面。

功能特性

• 绘图网格界面:

  • 提供一个 16x16 的网格，其中每个单元格可以在两种状态之间切换（填充或空）。
  • 提供一个清除网格按钮来重置所有单元格。

• 服务器功能:

  • 启动绘图会话: 初始化一个新的会话并启动 UI。
  • 切换单元格: 通过命令接口切换单个单元格的颜色。
  • 获取网格状态: 以文本表示形式检索当前网格配置。

• 持久化: 网格状态保存到 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 .
   

使用方法

作为独立的 MCP 服务器

运行服务器以打开绘图窗口：

interactive-draw-mcp

与 Goose 一起使用

选项 1：使用 Goose CLI（推荐）

启动 Goose 并启用您的扩展：

# 本地开发
goose session --with-extension "python -m interactive-draw-mcp"

工具

• 服务器工具:
  • start_drawing_session(): 初始化绘图会话并打开 UI。
  • 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 的工具调用直接反映到网格状态，反之亦然。

优势

• 职责分离: 保持服务器逻辑和 UI 呈现之间的清晰分离。
• 改进的用户体验: 提供直观的视觉反馈以及基于文本的命令界面。
• 适应性: 可以扩展到涉及 AI 和交互式 UI 的更复杂的应用程序。