Create a Custom Server

基本能力

产品定位

simple-calculator-mcp-server 是一个用于扩展 AI 助手功能的计算工具服务，通过 MCP 协议与 AI 助手（如 Claude for Desktop）集成。

核心功能

• 提供四个基本算术工具：
• add: 加法运算
• subtract: 减法运算
• multiply: 乘法运算
• divide: 除法运算
• 支持本地运行，通过 MCP 协议与 AI 助手通信。

适用场景

• 在 AI 助手对话中执行数学运算。
• 作为开发者的入门项目，学习如何构建 MCP 服务器。

工具列表

• add: 执行两个数字的加法运算。
• subtract: 执行两个数字的减法运算。
• multiply: 执行两个数字的乘法运算。
• divide: 执行两个数字的除法运算（处理除零错误）。

常见问题解答

• 为什么选择 Claude for Desktop 而不是 Claude.ai？ 因为 MCP 服务器目前仅支持本地运行的桌面客户端。
• 如何配置 Claude for Desktop 以使用此服务器？ 需要在 Claude for Desktop 的配置文件中添加服务器的启动命令和路径。

使用教程

使用依赖

• Python 3.10 或更高版本。
• Python MCP SDK 1.2.0 或更高版本。

安装依赖命令

# MacOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装教程

MacOS/Linux

# 创建项目目录
uv init calculator
cd calculator

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate

# 安装依赖
uv add "mcp[cli]"

# 创建服务器文件
touch calculator.py

Windows

# 创建项目目录
uv init calculator
cd calculator

# 创建并激活虚拟环境
uv venv
.venv\Scripts\activate

# 安装依赖
uv add "mcp[cli]"

# 创建服务器文件
new-item calculator.py

调试方式

• 运行服务器：

uv run calculator.py

• 配置 Claude for Desktop 以使用服务器：
• 编辑配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json（MacOS/Linux）或 $env:AppData\Claude\claude_desktop_config.json（Windows）。
• 添加服务器配置并重启 Claude for Desktop。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。