EAGS4 MCP Server Client

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

本项目打造了一个多组件平台（MCP）服务器，并集成了双子星AI功能。用户可借助自然语言指令，轻松执行各类数学运算和复杂任务，极大提升操作的便捷性与效率。

🚀 快速开始

本项目实现了一个多组件平台（MCP）服务器，并集成了双子星AI功能，你可以按照以下步骤进行操作：

1. 确保满足先决条件：
   • Python 3.8或更高版本
   • Google双子星API密钥
   • macOS（用于Keynote集成）
2. 完成安装步骤（具体见下方📦 安装指南）。
3. 启动服务器和客户端（具体见下方💻 使用示例）。

✨ 主要特性

• 数学运算
  • 基本算术：涵盖加法、减法、乘法、除法等基础运算。
  • 高级数学：支持幂、平方根、立方根等高级运算。
  • 特殊函数：包含阶乘、对数、三角函数等特殊计算。
  • 列表操作：可进行列表求和、指数求和等操作。
• 字符串处理
  • 能将字符串转换为ASCII值。
  • 可处理字符数组。
• Keynote集成
  • 能够打开Keynote应用程序。
  • 可绘制自定义尺寸的矩形。
  • 能在形状中添加文本。
• AI驱动的任务执行
  • 借助双子星AI进行自然语言处理。
  • 可迭代解决问题。
  • 能根据用户查询自动选择工具。

📦 安装指南

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
   

💻 使用示例

基础用法

启动服务器

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
    }
}

📚 详细文档

项目结构

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

可用工具

数学运算工具

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

字符串处理工具

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

演示视频

错误处理

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

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

调试信息

调试输出包括：

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

如何贡献

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

📄 许可证

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

致谢

感谢以下支持：

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