MCP Server with Gemini AI Integration

基本能力

产品定位

EAGS4-MCP-Server-Client 是一个集成了 Gemini AI 的多组件平台（MCP）服务器，旨在通过自然语言命令自动化执行数学运算、字符串处理和 Keynote 集成等任务。

核心功能

• 数学运算：支持基本算术、高级数学运算、特殊函数和列表操作。
• 字符串处理：包括字符串到 ASCII 值的转换和字符数组处理。
• Keynote 集成：支持打开 Keynote 应用、绘制自定义尺寸的矩形和在形状中添加文本。
• AI 驱动的任务执行：利用 Gemini AI 进行自然语言处理，自动选择工具并解决问题。

适用场景

• 自动化数学计算和字符串处理。
• 与 Keynote 集成的自动化演示制作。
• 通过自然语言命令快速执行复杂任务。

工具列表

1. 数学工具：包括加法、减法、乘法、除法、幂运算、平方根、立方根、阶乘、对数、三角函数等。
2. 字符串处理工具：字符串到 ASCII 值的转换和指数和计算。
3. Keynote 工具：打开 Keynote、绘制矩形、在形状中添加文本。

常见问题解答

• 依赖问题：确保安装 Python 3.8 或更高版本，并获取 Google Gemini API 密钥。
• Keynote 集成：仅支持 macOS 系统。
• 错误处理：系统包含全面的错误处理机制，包括超时处理、类型转换验证和参数验证。

使用教程

使用依赖

1. 安装 Python 3.8 或更高版本。
2. 获取 Google Gemini API 密钥。
3. 确保系统为 macOS（如需使用 Keynote 集成）。

安装教程

1. 克隆仓库：

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

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

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

1. 安装依赖：

pip install -r requirements.txt

1. 创建 .env 文件并添加 Gemini API 密钥：

GEMINI_API_KEY=your_api_key_here

调试方式

1. 启动 MCP 服务器：

python mcp_server.py

1. 运行客户端应用：

python talk2mcp.py

1. 输入查询命令，如 "Add 5 and 3" 或 "Find the ASCII values of characters in INDIA"。
2. 调试信息将打印到控制台，包括工具执行详情、参数处理和错误消息。

许可证

该项目遵循 MIT 开源许可条款。