基础数学 MCP 服务器

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

什么是 MCP？

MCP (Model Context Protocol) 是由 Anthropic 开发的一个开源标准，允许外部工具、API 或脚本以结构化和交互式的方式暴露给大型语言模型（LLMs）——例如 Claude。

通过 MCP，开发者可以：

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

自定义 MCP 服务器是什么？

Custom MCP Server 是一个基于 Python 的服务，使用 mcp-server 库实现 MCP 规范。这些服务器：

• 定义可调用工具（@tool）用于计算或自动化。
• 主机资源（@resource）如文档或参考数据。
• 在本地或远程运行，并响应 MCP 客户端——例如 Claude Desktop。

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

我们构建的内容

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

工具：

• add(a, b) — 返回两个数字的和。
• subtract(a, b) — 返回从 a 中减去 b 的结果。
• multiply(a, b) — 返回 a 和 b 的乘积。
• divide(a, b) — 返回 a 除以 b 的商。处理除以零的情况。

资源：

• calculator://help — 一个 Markdown 格式的帮助文件，解释所有工具的使用方法。

先决条件

在开始之前，请确保安装了以下内容：

• Python 3.9+
• Claude Desktop（或其他 MCP 兼容界面）
• uv 运行时（用于快速、隔离式的 Python 执行）

安装步骤

步骤 1：安装 uv（运行 MCP 服务器所需的必备工具）

macOS/Linux:

curl -Ls https://astro.build/install/uv | bash

这将把 uv 安装到 ~/.local/bin/uv

Windows (PowerShell):

irm https:// astro.build/install/uv.ps1 | iex

你可能需要重新启动终端或将 uv 添加到 PATH。

步骤 2：安装 MCP 服务器

使用 uv 安装 mcp-server 并运行你的服务器：

uv pip install mcp-server

要手动运行服务器：

uv run mcp-server

与 Claude Desktop 的集成

一旦安装完成，你需要配置 Claude 发现这个 MCP 服务器。

找到 claude_desktop_config.json

此文件包含 Claude Desktop 使用的 MCP 服务器配置。添加或更新如下：

如果你没有任何 MCP 服务器：

将整个代码块粘贴到你的配置中：

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "mcp-server"
      ]
    }
  }
}

如果你已经有 MCP 服务器：

只需在 "mcpServers" 对象中添加以下条目：

{
  "mcpServers": {
    "your-mcp-server-name": {
      "command": "uv",
      "args": [
        "run",
        "mcp-server"
      ]
    }
  }
}

注意事项

• 确保 claude_desktop_config.json 文件位于默认的配置路径中，通常为：~/Library/Application Support/Claude/
• 如果你的 MCP 服务器暴露在公共网络上，请确保采取适当的安全措施，例如使用 HTTPS 和身份验证。

完成上述步骤后，你的基础数学 MCP 服务器应该可以正常运行并与 Claude Desktop 集成。