🚀 多组件平台（MCP）服务器与双子星AI集成
本项目打造了一个多组件平台（MCP）服务器，并集成了双子星AI功能。用户可借助自然语言指令，轻松执行各类数学运算和复杂任务，极大提升操作的便捷性与效率。
🚀 快速开始
本项目实现了一个多组件平台（MCP）服务器，并集成了双子星AI功能，你可以按照以下步骤进行操作：
- 确保满足先决条件：
- Python 3.8或更高版本
- Google双子星API密钥
- macOS（用于Keynote集成）
- 完成安装步骤（具体见下方📦 安装指南）。
- 启动服务器和客户端（具体见下方💻 使用示例）。
✨ 主要特性
- 数学运算
- 基本算术：涵盖加法、减法、乘法、除法等基础运算。
- 高级数学：支持幂、平方根、立方根等高级运算。
- 特殊函数：包含阶乘、对数、三角函数等特殊计算。
- 列表操作：可进行列表求和、指数求和等操作。
- 字符串处理
- 能将字符串转换为ASCII值。
- 可处理字符数组。
- Keynote集成
- 能够打开Keynote应用程序。
- 可绘制自定义尺寸的矩形。
- 能在形状中添加文本。
- AI驱动的任务执行
- 借助双子星AI进行自然语言处理。
- 可迭代解决问题。
- 能根据用户查询自动选择工具。
📦 安装指南
- 克隆仓库：
git clone https://github.com/your-repository.git - 创建并激活虚拟环境（推荐使用Python 3.8+）：
python -m venv mcp-venv source mcp-venv/bin/activate # 在Windows上使用 `mcp-venv\Scripts\activate` - 安装依赖项：
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响应超时检测
- 类型转换验证
- 工具可用性检查
- 参数有效性验证
调试信息
调试输出包括：
- 工具执行细节
- 参数处理流程
- 结果格式化步骤
- 错误消息和堆栈跟踪
如何贡献
- 叉仓库
- 创建功能分支
- 提交更改
- 推送到分支
- 创建拉取请求
📄 许可证
此项目根据MIT许可证授权，具体内容请参见LICENSE文件。
致谢
感谢以下支持：
- Google双子星AI提供自然语言处理能力
- MCP框架提供工具管理功能
- Python社区提供的各种库