MCP计算器服务

一个基于Model Context Protocol (MCP)的简单计算器服务,为MCP客户端提供基础数学运算功能。

  • by simonberner
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 simonberner/mcp-server-calculator

使用说明

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

关于

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

什么是MCP?

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

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

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

技术栈

  • Python 3
  • Pytest
  • MCP-SDK
  • MCP-CLI
  • Nix(可选)

如何设置和使用

史密瑟里

通过以下方式自动安装Claude Desktop的mcp服务器计算器 史密瑟里:

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

开发设置

由于我们在这个项目中使用Nix是为了拥有一个可重复和隔离的开发环境,因此不需要安装Python或任何其他依赖项。你会从盒子里得到你需要的一切。此外,也不需要使用Python创建虚拟环境 venv 或 poetry,但您必须愿意在系统上安装Nix。

  • 安装 direnv (用于加载开发环境)
  • 安装 锂离子
  • 克隆此存储库
  • 将cd放入目录
  • 跑 direnv allow
  • 跑 pytest

替代

如果你不想走Smithery或Nix路线,你当然也可以使用 紫外线 构建包/项目。以下是一些指导:

# Install uv (see https://docs.astral.sh/uv/getting-started/installation/)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create a virtual environment named .venv
uv venv

# Activate the virtual environment (example for bash/zsh)
source .venv/bin/activate

# Now run the install or build commands
uv pip install -e .
# or
uv pip wheel . -w dist

在本地运行和测试服务器

  • MCP检查员 是一个方便的GUI工具,允许您通过web界面测试自定义MCP服务器http://localhost:5173而无需将其与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主机,您需要 专业计划 能够将Cascade(作为MCP客户端)与MCP服务器一起使用。

问题

检查 问题 查看当前问题或打开新问题。

资源

鸣谢

很高兴知道

尼克斯

云耀