Basic Math MCP Server

基础数学 MCP 服务

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

---

什么是 MCP？

MCP（Model Context Protocol） 是由 Anthropic 开发的一项开放标准，可让外部工具、API 或脚本以结构化、交互式的方式提供给 Claude 等大模型（LLM）使用。

借助 MCP，开发者可以：

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

---

什么是自定义 MCP 服务？

自定义 MCP 服务 是一种基于 Python 的服务，使用 mcp-server 库实现 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 的商，并处理除以零的情况。

资源：

• 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 格式有效（例如，各条目之间需用逗号分隔）。

---

使用示例

此图片展示了基础数学 MCP 服务如何与 Claude Desktop 实时协同工作。

---

工具帮助资源

你也可以使用内置帮助：

resource: calculator://help

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

---

实用链接

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

---