AI导哈

数学运算与自然语言处理服务器

一个集成了Gemini AI的多组件平台服务器，支持通过自然语言命令执行数学运算和复杂任务。

  • by walnashgit
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 walnashgit/eags4-mcp-server-client

使用说明

集成Gemini AI的MCP服务器

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

特性

  • 数学运算

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

  • 字符串处理

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

  • 主题整合

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

  • AI驱动的任务执行

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

先决条件

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

安装

  1. 克隆存储库：
git clone <repository-url>
cd <repository-name>
  1. 创建并激活虚拟环境：
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装依赖项：
pip install -r requirements.txt
  1. 创建一个 .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
  1. 在另一个终端中，运行客户端应用程序：
python talk2mcp.py

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

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

python talk2mcp.py

客户将：

  1. 检查服务器是否正在运行
  2. 如果需要，启动服务器
  3. 自动建立连接
  4. 提示您的查询

使用应用程序

  1. 出现提示时输入您的查询。示例：

    • “加5和3”
    • “查找印度字符的ASCII值”
    • “启动主题演讲应用程序并绘制一个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. 注释记号工具

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

演示

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

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

错误处理

该系统包括全面的错误处理：

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

调试

调试信息打印到控制台，包括：

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

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 提交您的更改
  4. 推到分支
  5. 创建拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

致谢

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

相关 MCP