MCP 简介；在 MacOS 上的 Keynote 中绘图和添加文本

本项目使用模型控制协议 (MCP) 实现了一个数学代理，该代理可以执行数学计算并在 macOS 上的 Keynote 中以可视方式呈现结果。该代理可以在 Keynote 幻灯片上绘制形状和添加文本，使其可用于创建数学演示文稿。

功能

• 数学运算（加法、减法、乘法、除法等）
• 高级数学函数（阶乘、对数、三角函数）
• ASCII 值计算和指数和运算
• Keynote 中的可视化演示：
  • 绘制矩形
  • 向幻灯片添加文本
  • 自动幻灯片管理

前提条件

• Python 3.x
• macOS（用于 Keynote 集成）
• Keynote 安装在您的系统上
• Google Gemini API 密钥

安装

1. 克隆存储库：

git clone <your-repository-url>
cd keynote-drawing-text

2. 安装所需的依赖项：

pip install -r requirements.txt

3. 在项目根目录中创建一个 .env 文件并添加您的 Gemini API 密钥：

GEMINI_API_KEY=your_api_key_here

项目结构

• mcp-server.py: 包含具有数学工具和 Keynote 集成的服务器实现
• mcp-client.py: 实现与 LLM 通信并管理工作流程的客户端
• requirements.txt: 列出所有 Python 依赖项

用法

客户端脚本 (mcp-client.py) 自动处理 MCP 服务器的启动和通信。您只需使用您的查询运行客户端：

python mcp-client.py "您的数学查询"

例如：

python mcp-client.py "查找 INDIA 中字符的 ASCII 值，然后返回这些值的指数和"

如果未提供查询，脚本将使用上述示例中提到的默认查询。

客户端将：

1. 自动在后台启动 MCP 服务器
2. 打开 Keynote 并创建一个新文档
3. 执行请求的数学运算
4. 在幻灯片上绘制一个矩形
5. 将结果作为文本添加到矩形中

注意：MCP 服务器由客户端脚本在内部管理，因此您无需手动启动它。服务器处理所有数学运算和 Keynote 交互，而客户端管理与语言模型的通信并协调整个工作流程。

可用的数学工具

• 基本运算：

  • 加法 (add)
  • 减法 (subtract)
  • 乘法 (multiply)
  • 除法 (divide)
  • 幂 (power)
  • 平方根 (sqrt)
  • 立方根 (cbrt)

• 高级运算：

  • 阶乘 (factorial)
  • 自然对数 (log)
  • 余数 (remainder)
  • 三角函数 (sin, cos, tan)
  • 斐波那契数列 (fibonacci_numbers)
  • ASCII 值计算 (strings_to_chars_to_int)
  • 指数和 (int_list_to_exponential_sum)

Keynote 集成

该项目包括 Keynote 集成的工具：

• mac_open_keynote: 打开 Keynote 并创建一个新文档
• mac_draw_rectangle: 在当前幻灯片上绘制一个矩形
• mac_add_text_in_keynote: 将文本添加到当前幻灯片

错误处理

该系统包括全面的错误处理，用于：

• API 通信问题
• 无效的数学运算
• Keynote 集成问题
• LLM 响应的超时处理

工具

• 用于框架的模型控制协议 (MCP)
• 用于语言模型的 Google Gemini
• 用于演示平台的 Apple Keynote

贡献

欢迎贡献！请随时提交 Pull Request。