集成Gemini AI的MCP服务器
该项目实现了一个与Gemini AI集成的多组件平台（MCP）服务器，允许用户通过自然语言命令执行各种数学运算和复杂任务。
特性
- 数学运算
- 基本算术（加、减、乘、除） - 高等数学（幂、平方根、立方根） - 特殊函数（阶乘、对数、三角函数） - 列表操作（列表求和、指数求和）
- 字符串处理
- 将字符串转换为ASCII值 - 处理字符数组
- 主题整合
- 打开Keynote应用程序 - 绘制具有自定义尺寸的矩形 - 向形状添加文本
- AI驱动的任务执行
- 使用Gemini AI进行自然语言处理 - 迭代问题求解 - 基于用户查询的自动工具选择
先决条件
- Python 3.8或更高版本
- Google Gemini API密钥
- macOS（用于Keynote集成）
安装
- 克隆存储库：
git clone
cd - 创建并激活虚拟环境：
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate- 安装依赖项：
pip install -r requirements.txt- 创建一个
.env文件，并添加您的Gemini API密钥：
GEMINI_API_KEY=your_api_key_here项目结构
mcp_server.py：包含MCP服务器实现和工具定义talk2mcp.py：与MCP服务器和Gemini AI接口的客户端应用程序.env：API密钥的配置文件requirements.txt：项目依赖关系
用法
您可以通过两种方式启动应用程序：
选项1：分别启动服务器和客户端
- 在一个终端中启动MCP服务器：
python mcp_server.py- 在另一个终端中，运行客户端应用程序：
python talk2mcp.py选项2：仅启动客户端（推荐）
如果服务器尚未运行，客户端应用程序可以自动启动服务器。只需运行：
python talk2mcp.py客户将：
- 检查服务器是否正在运行
- 如果需要，启动服务器
- 自动建立连接
- 提示您的查询
使用应用程序
- 出现提示时输入您的查询。示例：
- “加5和3” - “查找印度字符的ASCII值” - “启动主题演讲应用程序并绘制一个300x400大小的矩形” - “计算5的阶乘”
- 键入“exit”退出应用程序。
注意：使用选项2时，当您退出客户端应用程序时，服务器将自动关闭。
可用工具
该系统提供以下工具：
- 数学工具
- 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)：三角函数
- 字符串处理工具
- strings_to_chars_to_int(string: str)：将字符串转换为ASCII值 - int_list_to_exponential_sum(int_list: list)：计算指数之和
- 注释记号工具
- open_keynote()：打开Keynote应用程序 - draw_rectangle_in_keynote(shapeWidth: int, shapeHeight: int)：绘制矩形 - add_text_to_keynote_shape(text: str)：向形状添加文本
演示
观看MCP服务器与Gemini AI集成的演示：
点击上图在YouTube上观看演示视频。
错误处理
该系统包括全面的错误处理：
- AI响应的超时处理
- 类型转换验证
- 工具可用性检查
- 参数验证
调试
调试信息打印到控制台，包括：
- 工具执行细节
- 参数处理
- 结果格式化
- 错误消息和堆栈跟踪
贡献
- 分叉存储库
- 创建要素分支
- 提交您的更改
- 推到分支
- 创建拉取请求
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
致谢
- Google Gemini AI具备自然语言处理能力
- MCP工具管理框架
- 本项目中使用的各种库的Python社区
