README.md•3.47 kB
# 计算器 MCP 服务器
[](https://smithery.ai/server/@mzdz/calc-mcp-server)
这是一个使用 [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol/python-sdk) 开发的计算器服务器，提供基本的算术运算功能。
## 功能特点
### 基本计算器功能
- 加法、减法、乘法、除法的基本运算
- 自动记录计算历史
- 通过资源 API 访问帮助信息和历史记录
### 高级计算器功能
- 幂运算和平方根计算
- 表达式计算（使用安全的表达式求值）
- 资源更新通知（当历史记录更新时）
## 安装要求
1. Python 3.7 或更高版本
2. MCP Python SDK
## 安装步骤
### Installing via Smithery
To install 计算器 MCP 服务器 for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@mzdz/calc-mcp):
```bash
npx -y @smithery/cli install @mzdz/calc-mcp --client claude
```
### Manual Installation
1. 克隆或下载此仓库
2. 安装依赖项：
```bash
pip install -r requirements.txt
```
## 使用方法
### 运行基本计算器服务器
```bash
python calculator_server.py
```
或者使用 MCP 命令：
```bash
mcp run calculator_server.py
```
### 运行高级计算器服务器
```bash
python advanced_calculator_server.py
```
### 运行客户端示例
```bash
python calculator_client.py
```
## 可用工具
### 基本工具：
- `add(a, b)`: 计算 a + b
- `subtract(a, b)`: 计算 a - b
- `multiply(a, b)`: 计算 a * b
- `divide(a, b)`: 计算 a / b
### 高级工具（仅在高级计算器中可用）：
- `power(base, exponent)`: 计算 base 的 exponent 次幂
- `sqrt(value)`: 计算平方根
- `evaluate_expression(expression)`: 计算数学表达式字符串
## 可用资源
- `calculator://help`: 获取帮助信息
- `calculator://history`: 获取计算历史记录
## 示例代码
### 使用 Python 客户端调用计算器服务器
```python
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
import asyncio
async def main():
server_params = StdioServerParameters(
command="python",
args=["advanced_calculator_server.py"],
)
async with stdio_client(server_params) as (read, write):
async with ClientSession(read, write) as session:
await session.initialize()
# 调用加法工具
result = await session.call_tool("add", {"a": 5, "b": 3})
print(f"5 + 3 = {result}")
# 读取计算历史
history, _ = await session.read_resource("calculator://history")
print(history)
if __name__ == "__main__":
asyncio.run(main())
```
## 项目结构
- `calculator_server.py`: 基本计算器 MCP 服务器
- `advanced_calculator_server.py`: 高级计算器 MCP 服务器，带有更多功能
- `calculator_client.py`: 计算器客户端示例
- `requirements.txt`: 项目依赖
- `README.md`: 项目文档
## 进一步开发
你可以通过以下方式扩展这个计算器服务器：
1. 添加更多数学函数（如三角函数、对数等）
2. 实现更复杂的表达式解析器
3. 添加图形界面
4. 实现持久化存储计算历史
5. 添加用户自定义变量和函数
## 许可证
MIT 许可证