Math MCP Server for MacOS

MCP 简介；在 MacOS 上向 Keynote 绘制和添加文本

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

特征

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

先决条件

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

安装

1. 克隆存储库：

2. 安装所需的依赖项：

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

项目结构

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

用法

客户端脚本 ( mcp-client.py ) 会自动处理 MCP 服务器的启动和通信。您只需运行以下命令：

例如：

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

客户将：

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 请求。