基础数学 MCP 服务器

一个简单而强大的 MCP 服务器，使用 FastMCP 框架 构建，支持基本数学运算如加法、减法、乘法和除法 — 可直接在 Claude Desktop 或任何 MCP 兼容环境中使用。

什么是 MCP？

MCP（模型上下文协议） 是由 Anthropic 开发的开源标准，允许外部工具、API 或脚本以结构化和交互式的方式与大型语言模型（LLMs）如 Claude 对接。

通过 MCP，开发者可以：

• 构建可被语言模型访问的自定义工具。
• 使用 Python 脚本或微服务扩展 Claude 的功能。
• 通过 @tool() 和 @resource() 装饰器共享结构化数据或自定义响应。

自定义 MCP 服务器是什么？

自定义 MCP 服务器 是使用 mcp-server 库实现的 Python 服务，符合 MCP 规范。这些服务器：

• 定义可调用工具（@tool）以进行计算或自动化操作。
• 主机资源（@resource）如文档或参考数据。
• 在本地或远程运行，响应来自 Claude Desktop 等 MCP 客户端的请求。

MCP 服务器实现了低延迟、安全且上下文化的语言模型与您代码之间的集成。

我们构建的内容

该项目是一个最小但完整的 MCP 服务器，提供基础算术功能。暴露的工具如下：

工具：

• add(a, b) – 返回两个数字的和。
• subtract(a, b) – 返回从 a 中减去 b 的结果。
• multiply(a, b) – 返回 a 和 b 的乘积。
• divide(a, b) – 返回 a 除以 b 的结果，支持处理除零异常。

资源：

• math_help() – 返回数学运算的示例和文档链接。

先决条件

在继续之前，请确保您满足以下要求：

• 安装 Python 3.6 或更高版本。
• 安装 Claude Desktop 并配置 API 密钥。
• 熟悉命令行界面（CLI）操作。

安装步骤

要使用此 MCP 服务器，请按照以下步骤进行：

第一步：安装 uv

在终端中运行以下命令以安装 uv 运行时：

# 在 macOS/Linux 上使用以下命令：
curl -o /usr/local/bin/uv https://github.com/samth/uv/releases/download/v1.0.0/uv-macos-x86_64 && chmod +x /usr/local/bin/uv

# 在 Windows 上使用以下命令（需要WSL支持）：
powershell.exe (iwr https://github.com/samth/uv/releases/download/v1.0.0/uv-win-x86_64).Content | Out-File -Path %ProgramFiles%\uv\uv.exe

第二步：安装和运行 MCP 服务器

使用 uv 运行时来安装和启动服务器：

uv run mcp_server.py

与 Claude Desktop 的集成

要使 Claude Desktop 识别您的 MCP 服务器，请按照以下步骤操作：

1. 打开 claudia.json 文件（通常位于用户主目录下的 .config/claudia/ 目录中）。
2. 添加或修改如下内容：

   {
     "mcpServers": [
       {
         "name": "math_server",
         "url": "http://localhost:8000"
       }
     ]
   }
   

3. 如果您已有其他服务器，请确保新配置与现有条目正确分隔。

使用示例

要测试 MCP 服务器的功能，可以直接在 Claude Desktop 中使用以下查询：

调用 add(2, 3)

工具帮助资源

要获取数学运算的帮助信息，请调用：

调用 math_help()

该函数将返回包含示例和文档链接的 JSON 格式响应。

有用的链接

• FastMCP 框架
• Claude Desktop 文档
• uv 运行时下载