基础数学 MCP 服务器

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

---

什么是 MCP？

MCP (模型上下文协议) 是 Anthropic 开发的一个开放标准，允许将外部工具、API 或脚本以结构化和交互式的方式暴露给大型语言模型 (LLM)，如 Claude。

使用 MCP，开发者可以：

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

---

什么是自定义 MCP 服务器？

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

• 定义可调用的工具 (@tool)，用于计算或自动化。
• 托管资源 (@resource)，如文档或参考数据。
• 在本地或远程运行，响应 MCP 客户端，如 Claude Desktop。

MCP 服务器实现了您自己的代码与 LLM 功能之间的低延迟、安全和上下文集成。

---

我们构建了什么

这个项目是一个最小但完整的 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" 对象：

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

确保您的 JSON 保持有效（例如，条目之间使用逗号）。

---

使用示例

此图像说明了 Basic Math MCP Server 如何与 Claude Desktop 实时工作。

---

工具帮助资源

您还可以使用内置的帮助：

resource: calculator://help

它返回 Markdown 格式的关于所有工具的说明。

---

实用链接

• PyPI: MCP-Server
• Claude + MCP 文档: Anthropic 官方指南
• GitHub UV 运行时: https://github.com/astral-sh/uv