How to build an MCP server - Calculator Example

基本能力

产品定位

mcp-server-calculator 是一个简单的计算器服务，旨在为 MCP 客户端提供基本的数学运算功能，扩展 LLMs 的计算能力。

核心功能

• 提供基本的数学运算功能
• 通过 MCP 协议与客户端交互
• 支持本地开发和测试

适用场景

• 为 LLMs 提供计算能力
• 作为 MCP 协议的示例项目
• 用于学习和理解 MCP 服务器的开发

工具列表

• MCP Inspector: 一个 GUI 工具，用于通过网页界面测试自定义 MCP 服务器
• MCP SDK: 用于开发 MCP 服务器的 Python 库
• MCP CLI: 用于管理 MCP 服务器的命令行工具

常见问题解答

• 使用 Windsurf IDE 作为 MCP Host 时，需要 Pro Plan 才能使用 Cascade (MCP Client) 与 MCP 服务器交互
• 当前问题可以在 GitHub Issues 中查看或提交新问题

使用教程

使用依赖

通过 Smithery 安装

npx -y @smithery/cli install @simonberner/mcp-server-calculator --client claude

开发环境设置 (使用 Nix)

1. 安装 direnv
2. 安装 Lix
3. 克隆仓库
4. 进入目录
5. 运行 direnv allow
6. 运行 pytest

替代方案 (不使用 Nix)

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建虚拟环境
uv venv

# 激活虚拟环境 (bash/zsh)
source .venv/bin/activate

# 安装或构建
uv pip install -e .
# 或
uv pip wheel . -w dist

安装教程

本地运行和测试服务器

mcp dev src/mcp_server_calculator/calculator.py

主机/客户端集成

在 mcp 配置中添加以下内容：

{
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": [
        "<YOUR-PATH>/mcp-server-calculator/src/mcp_server_calculator/calculator.py"
      ]
    }
  }
}

调试方式

• 使用 MCP Inspector 测试服务器
• 运行 pytest 进行测试

许可证

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