MCP Server with Gemini AI Integration

与 Gemini AI 集成的 MCP 服务

本项目实现了一个集成 Gemini AI 的多组件平台（MCP）服务，用户可以通过自然语言命令执行各种数学运算和复杂任务。

功能

• 数学运算

  • 基本算术运算（加、减、乘、除）
  • 高级数学运算（乘方、平方根、立方根）
  • 特殊函数（阶乘、对数、三角函数）
  • 列表运算（列表求和、指数和）

• 字符串处理

  • 将字符串转换为 ASCII 值
  • 处理字符数组

• Keynote 集成

  • 打开 Keynote 应用
  • 绘制自定义尺寸的矩形
  • 向形状中添加文本

• AI 驱动的任务执行

  • 使用 Gemini AI 进行自然语言处理
  • 迭代式问题求解
  • 根据用户查询自动选择工具

前置条件

• Python 3.8 或更高版本
• Google Gemini API 密钥
• macOS（用于 Keynote 集成）

安装

1. 克隆仓库：

git clone <repository-url>
cd <repository-name>

2. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

4. 在项目根目录创建 .env 文件，并添加 Gemini API 密钥：

GEMINI_API_KEY=your_api_key_here

项目结构

• mcp_server.py：包含 MCP 服务实现和工具定义
• talk2mcp.py：与 MCP 服务和 Gemini AI 交互的客户端应用
• .env：API 密钥配置文件
• requirements.txt：项目依赖项

使用方法

你可以通过以下两种方式启动应用：

选项 1：分别启动服务端和客户端

1. 在一个终端中启动 MCP 服务：

python mcp_server.py

2. 在另一个终端中运行客户端应用：

python talk2mcp.py

选项 2：仅启动客户端（推荐）

如果 MCP 服务尚未运行，客户端应用可以自动启动它。只需运行：

python talk2mcp.py

客户端将：

1. 检查服务是否正在运行
2. 根据需要启动服务
3. 自动建立连接
4. 提示你输入查询

使用应用

1. 根据提示输入查询。示例：

   • “计算 5 加 3”
   • “查找 INDIA 中各字符的 ASCII 值”
   • “启动 Keynote 应用并绘制一个 300x400 的矩形”
   • “计算 5 的阶乘”

2. 输入 'exit' 退出应用。

注意：使用选项 2 时，退出客户端应用后，服务将自动关闭。

可用工具

系统提供以下工具：

1. 数学工具

   • add(a: int, b: int)：将两个数相加
   • subtract(a: int, b: int)：将两个数相减
   • multiply(a: int, b: int)：将两个数相乘
   • divide(a: int, b: int)：将两个数相除
   • power(a: int, b: int)：计算幂
   • sqrt(a: int)：计算平方根
   • cbrt(a: int)：计算立方根
   • factorial(a: int)：计算阶乘
   • log(a: int)：计算对数
   • sin(a: int)、cos(a: int)、tan(a: int)：三角函数

2. 字符串处理工具

   • strings_to_chars_to_int(string: str)：将字符串转换为 ASCII 值
   • int_list_to_exponential_sum(int_list: list)：计算指数和

3. Keynote 工具

   • open_keynote()：打开 Keynote 应用
   • draw_rectangle_in_keynote(shapeWidth: int, shapeHeight: int)：绘制矩形
   • add_text_to_keynote_shape(text: str)：向形状中添加文本

演示

观看集成 Gemini AI 的 MCP 服务演示：

点击上方图片，在 YouTube 上观看演示视频。

错误处理

系统包含完善的错误处理机制：

• AI 响应超时处理
• 类型转换验证
• 工具可用性检查
• 参数验证

调试

调试信息会输出到控制台，包括：

• 工具执行详情
• 参数处理
• 结果格式化
• 错误消息和堆栈跟踪

贡献

1. Fork 此仓库
2. 创建功能分支
3. 提交更改
4. 推送到该分支
5. 创建 Pull Request

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

致谢

• 感谢 Google Gemini AI 提供自然语言处理能力
• 感谢 MCP 框架提供工具管理功能
• 感谢 Python 社区提供本项目使用的各种库