MCP简介;在MacOS上绘制和添加文本到Keynote
该项目使用模型控制协议(MCP)实现了一个数学代理,该代理可以在macOS上的Keynote中执行数学计算并直观地呈现结果。该代理可以绘制形状并将文本添加到Keynote幻灯片中,这对于创建数学演示文稿非常有用。
特性
- 数学运算(加法、减法、乘法、除法等)
- 高级数学函数(阶乘、对数、三角函数)
- ASCII值计算和指数求和运算
- Keynote中的视觉演示:
- 绘制矩形 - 向幻灯片添加文本 - 自动幻灯片管理
先决条件
- Python 3.x
- macOS(用于Keynote集成)
- Keynote已安装在您的系统上
- Google Gemini API密钥
安装
- 克隆存储库:
git clone
cd keynote-drawing-text- 安装所需的依赖项:
pip install -r requirements.txt- 创建一个
.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 "Your mathematical query here"例如:
python mcp-client.py "Find the ASCII values of characters in INDIA and then return sum of exponentials of those values"如果没有提供查询,则脚本将使用上述示例中提到的默认查询。
客户将:
- 在后台自动启动MCP服务器
- 打开Keynote并创建新文档
- 执行所请求的数学运算
- 在幻灯片上画一个矩形
- 将结果添加为矩形内的文本
注意: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集成工具:
mac_open_keynote:打开Keynote并创建新文档mac_draw_rectangle:在当前幻灯片上绘制矩形mac_add_text_in_keynote:向当前幻灯片添加文本
错误处理
该系统包括全面的错误处理,用于:
- API通信问题
- 无效的数学运算
- 主题集成问题
- LLM响应的超时处理
工具
- 框架的模型控制协议(MCP)
- Google Gemini语言模型
- 演示平台的苹果主题演讲
贡献
欢迎投稿!请随时提交拉取请求。
