# 简单计算器MCP工具
这是一个简单的计算器MCP（Model Context Protocol）工具，提供基本的数学运算功能。
<!-- MCP_SERVER_CONFIG_START -->
```json
{
"name": "simple-calculator-mcp",
"version": "1.0.0",
"description": "一个简单的计算器MCP工具，提供基本的数学运算功能",
"author": "SanLangLOVE",
"license": "MIT",
"runtime": "node",
"entry": "dist/index.js",
"dependencies": {
"@modelcontextprotocol/sdk": "^0.4.0"
},
"tools": [
{
"name": "add",
"description": "计算两个数字的和",
"parameters": {
"type": "object",
"properties": {
"a": {
"type": "number",
"description": "第一个数字"
},
"b": {
"type": "number",
"description": "第二个数字"
}
},
"required": ["a", "b"]
}
},
{
"name": "subtract",
"description": "计算两个数字的差",
"parameters": {
"type": "object",
"properties": {
"a": {
"type": "number",
"description": "被减数"
},
"b": {
"type": "number",
"description": "减数"
}
},
"required": ["a", "b"]
}
},
{
"name": "multiply",
"description": "计算两个数字的乘积",
"parameters": {
"type": "object",
"properties": {
"a": {
"type": "number",
"description": "第一个数字"
},
"b": {
"type": "number",
"description": "第二个数字"
}
},
"required": ["a", "b"]
}
},
{
"name": "divide",
"description": "计算两个数字的商",
"parameters": {
"type": "object",
"properties": {
"a": {
"type": "number",
"description": "被除数"
},
"b": {
"type": "number",
"description": "除数"
}
},
"required": ["a", "b"]
}
},
{
"name": "power",
"description": "计算一个数字的幂",
"parameters": {
"type": "object",
"properties": {
"base": {
"type": "number",
"description": "底数"
},
"exponent": {
"type": "number",
"description": "指数"
}
},
"required": ["base", "exponent"]
}
}
]
}
```
<!-- MCP_SERVER_CONFIG_END -->
## 功能特性
- 加法运算
- 减法运算
- 乘法运算
- 除法运算
- 幂运算
## 安装和设置
### 1. 安装依赖
```bash
npm install
```
### 2. 构建项目
```bash
npm run build
```
### 3. 配置MCP客户端
在你的MCP客户端配置文件中添加以下配置：
#### 对于Claude Desktop (macOS)
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"simple-calculator": {
"command": "node",
"args": ["/Users/sanrosang/Documents/mcp/dist/index.js"],
"env": {}
}
}
}
```
#### 对于其他MCP客户端
根据你的MCP客户端文档，添加相应的服务器配置。
## 使用方法
启动MCP客户端后，你可以使用以下工具：
### 1. 加法 (add)
- 参数：`a` (数字), `b` (数字)
- 示例：计算 5 + 3
### 2. 减法 (subtract)
- 参数：`a` (被减数), `b` (减数)
- 示例：计算 10 - 4
### 3. 乘法 (multiply)
- 参数：`a` (数字), `b` (数字)
- 示例：计算 6 × 7
### 4. 除法 (divide)
- 参数：`a` (被除数), `b` (除数)
- 示例：计算 15 ÷ 3
- 注意：除数不能为零
### 5. 幂运算 (power)
- 参数：`base` (底数), `exponent` (指数)
- 示例：计算 2^8
## 开发
### 运行开发版本
```bash
npm run dev
```
### 项目结构
```
├── src/
│ └── index.ts # 主程序文件
├── dist/ # 编译输出目录
├── package.json # 项目配置
├── tsconfig.json # TypeScript配置
└── README.md # 说明文档
```
## 扩展功能
你可以通过修改 `src/index.ts` 文件来添加更多功能：
1. 在 `tools` 数组中添加新的工具定义
2. 在 `CallToolRequestSchema` 处理函数中添加对应的处理逻辑
## 许可证
MIT License
## ModelScope 部署
本项目已配置为支持ModelScope平台部署。主要配置信息：
- **运行时**: Node.js
- **入口文件**: `dist/index.js`
- **依赖管理**: npm
- **构建命令**: `npm run build`
- **启动命令**: `node dist/index.js`
### 部署要求
1. 确保项目已构建（`npm run build`）
2. 确保所有依赖已安装（`npm install`）
3. 确保`dist/index.js`文件存在且可执行
### ModelScope平台配置
在ModelScope平台的设置页面中，使用以下配置：
**服务名称**: `mcp-calculator`
**服务描述**: `一个简单的计算器MCP工具，提供基本的数学运算功能`
**运行环境**: `Node.js`
**启动命令**: `node dist/index.js`
**工作目录**: `/`
### 工具列表
本MCP服务器提供以下工具：
1. **add** - 加法运算
2. **subtract** - 减法运算
3. **multiply** - 乘法运算
4. **divide** - 除法运算
5. **power** - 幂运算
所有工具都支持数字类型参数，并提供完整的错误处理机制。
### 环境变量
```json
{
"NODE_ENV": "production"
}
```
### 健康检查
服务支持MCP协议标准健康检查，确保服务正常运行。
