MathAgent

一个最小化的数学代理，将所有计算委托给MCP（模型上下文协议）服务器。该代理使用MCP工具进行每一步操作——不进行心算——因此您能得到一致且可检查的结果。

内容简介

• 代理：使用pydantic-ai构建，通过MCP标准I/O连接
• MCP服务器：由fastmcp驱动，提供数学工具

可用的MCP工具

• 加法
• 减法
• 乘法
• 除法
• 幂运算
• 对数

即将推出：

• 模运算

环境要求

• Python 3.13+
• uv（Python包/依赖管理器）
• Groq API密钥（用于LLM模型）
• Logfire令牌（用于仪器）

安装步骤

1. 克隆仓库
2. 创建您的环境文件
   • 设置以下密钥：
     • groq_key — 您的Groq API密钥
     • logfire_key — 您的Logfire令牌

运行代理

使用uv运行以解决依赖关系并启动作为工具集的MCP服务器：

uv run agent.py

注意事项：

• 代理配置为使用Groq模型qwen/qwen3-32b（参见agent.py）。您可以根据需要更换模型。
• 代理设计上会拒绝非数学问题。
• 所有计算都会通过在mcp-server.py中定义的MCP工具进行。

贡献

欢迎贡献——请随意打开问题或提交拉取请求。