多组件平台（MCP）服务器与双子星AI集成

该项目实现了一个多组件平台（MCP）服务器，并集成了双子星AI功能，使用户能够通过自然语言指令执行各种数学运算和复杂任务。

功能

• 数学运算

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

• 字符串处理

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

• Keynote集成

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

• AI驱动的任务执行

  • 使用双子星AI进行自然语言处理
  • 迭代解决问题
  • 根据用户查询自动选择工具

先决条件

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

安装步骤

1. 克隆仓库：

   git clone https://github.com/your-repository.git
   

2. 创建并激活虚拟环境（推荐使用Python 3.8+）：

   python -m venv mcp-venv
   source mcp-venv/bin/activate  # 在Windows上使用 `mcp-venv\Scripts\activate`
   

3. 安装依赖项：

   pip install -r requirements.txt
   

项目结构

mcp-server/
├── server.py          # MCP服务器主程序
├── tools/            # 集成工具目录
│   ├── math_tool.py  # 数学运算工具
│   └── string_tool.py# 字符串处理工具
└── requirements.txt  # 项目依赖项列表

使用方法

启动服务器

python server.py

启动客户端

python client.py

示例查询

• 计算：What is the sum of 10 and 20?
• 转换：Convert "Hello, World!" to ASCII.
• 绘制矩形：

  {
    "action": "draw_rectangle",
    "params": {
      "width": 500,
      "height": 300
    }
  }
  

可用工具

数学运算工具

• add: 计算两个数字的和。
• subtract: 计算两个数字的差。
• multiply: 计算两个数字的乘积。
• divide: 计算两个数字的商。

字符串处理工具

• to_ascii: 将字符串转换为ASCII表示。
• reverse: 反转给定字符串。
• uppercase: 将字符串转换为大写。

演示视频

错误处理

系统提供以下错误处理机制：

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

调试信息

调试输出包括：

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

如何贡献

1. 叉仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建拉取请求

许可证

此项目根据MIT许可证授权，具体内容请参见LICENSE文件。

致谢

感谢以下支持：

• Google双子星AI提供自然语言处理能力
• MCP框架提供工具管理功能
• Python社区提供的各种库