MCP 服务器

How to build an MCP server - Calculator Example

一个展示如何构建简单 MCP 服务器（并将其部署在 Smithery 上！）的示例项目

simonberner

研究与数据

访问服务器

README

如何构建 MCP 服务器 - 计算器示例

关于

这是一个非常简单的示例，展示了如何构建一个 MCP 服务器，该服务器向 MCP 客户端提供基本的数学运算。

什么是 MCP？

模型上下文协议 (MCP) 是一种使 LLM 能够访问自定义工具和服务的协议。 MCP 客户端可以向 MCP 服务器发出请求，以访问它们提供的工具。此示例代表一个简单的计算器服务器，该服务器向客户端提供基本的数学运算。

“MCP 可以为 AI 模型与外部系统交互提供一种单一的标准化方式。您只需编写一次代码，所有 AI 系统都可以使用它。” 1

“服务器是丰富 LLM 外部数据和上下文的基本构建块。” 2

Chat MCP Calculator

技术栈

Python3
Pytest
MCP SDK
MCP CLI
Nix (可选)

如何设置和使用

Smithery

要通过 Smithery 为 Claude Desktop 自动安装 mcp-server-calculator：

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

开发设置

由于我们在本项目中使用 Nix 来获得可重现且隔离的开发环境，因此无需安装 Python 或任何其他依赖项。您将获得所需的一切。此外，无需使用 venv 或 poetry 在 Python 中创建虚拟环境，但您必须愿意在您的系统上安装 Nix。

安装 direnv（用于加载开发环境）
安装 Lix
克隆此存储库
cd 进入目录
运行 direnv allow
运行 pytest

替代方案

如果您不想采用 Smithery 或 Nix 路线，您当然也可以使用 uv 来构建包/项目。以下是一些指导：

# 安装 uv (参见 https://docs.astral.sh/uv/getting-started/installation/)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建一个名为 .venv 的虚拟环境
uv venv

# 激活虚拟环境（bash/zsh 示例）
source .venv/bin/activate

# 现在运行安装或构建命令
uv pip install -e .
# 或
uv pip wheel . -w dist

在本地运行和测试服务器

MCP Inspector 是一个方便的 GUI 工具，可让您通过 http://localhost:5173 上的 Web 界面测试您的自定义 MCP 服务器，而无需将其与 LLM / AI 代理集成。

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"
      ]
    }
  }
}

备注

当使用 Windsurf IDE 作为 MCP 主机时，您需要拥有 Pro Plan 才能将 Cascade（作为 MCP 客户端）与 MCP 服务器一起使用。

问题

查看 Issues 以查看当前问题或打开新问题。

资源

鸣谢

Nix-Setup 取自 ical2json

须知

Nix

推荐服务器

Crypto Price & Market Analysis MCP Server

一个模型上下文协议 (MCP) 服务器，它使用 CoinCap API 提供全面的加密货币分析。该服务器通过一个易于使用的界面提供实时价格数据、市场分析和历史趋势。 (Alternative, slightly more formal and technical translation): 一个模型上下文协议 (MCP) 服务器，利用 CoinCap API 提供全面的加密货币分析服务。该服务器通过用户友好的界面，提供实时价格数据、市场分析以及历史趋势数据。

精选

TypeScript