AI导哈

计算器工具服务

一个基于Minimal Model Context Protocol (MCP) 的服务器，提供基本的计算器功能（加、减、乘、除、取模、幂、平方根），适用于MCP兼容客户端如Claude Desktop。

  • by rohit-yadavv
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 rohit-yadavv/calculator-mcp

使用说明

计算器-MCP（或“微控制器协议计算器”，具体翻译取决于上下文中的MCP含义）

概述

最小模型上下文协议（MCP）服务器，提供基本计算器工具（加法、减法、乘法、除法、取模、幂运算、平方根） fastmcp。

要求

  • Python 3.12+
  • 其中之一：
    • 紫外线（推荐）
    • 或者 pip/venv

安装

使用紫外线（推荐）

uv sync

使用 pip

python -m venv .venv
.\.venv\Scripts\activate
pip install -U pip
pip install -e .

启动服务器

uv run python server.py

或者使用 pip/venv：

python server.py

服务器启动了一个适用于MCP兼容客户端（例如，Claude Desktop）的MCP端点。

与 Cursor 或 VS Code 配合使用（HTTP MCP）

如果您的MCP客户端支持通过HTTP服务器进行连接 mcp.json （例如，Cursor，或带有MCP客户端扩展的VS Code），将此条目添加到您的 mcp.json 立即使用托管的计算器服务器：

{
  "calculator-mcp": {
    "url": "https://calculator-mcp-01.fastmcp.app/mcp",
    "type": "http"
  }
}
  • 光标（Windows） mcp.json 路径： C:\Users\<you>\.cursor\mcp.json
  • VS Code：使用相同的代码片段与任何读取的MCP客户端/扩展程序 mcp.json

保存后，请重启客户端以便其进行发现（或检测） calculator-mcp.

可用的工具

  • `add(a: int, b: int) -> int` 翻译成中文是：`加法函数，接收两个整数参数a和b，返回它们的和（整数类型）`
  • `subtract(a: int, b: int) -> int` 翻译成中文是：`减法函数，接收两个整数参数a和b，返回它们的差（整数类型）`
  • multiply(a: int, b: int) -> int 翻译为中文是：乘法函数（a: 整数, b: 整数）-> 整数
  • `divide(a: float, b: float) -> float`（除以零时会报错）
  • `modulus(a: int, b: int) -> int`（除以零时出错）
  • power(a: float, b: float) -> float 翻译为中文是：幂函数（a: 浮点数, b: 浮点数）-> 浮点数
  • `sqrt(x: float) -> float`（对负数输入报错）

示例提示（Claude）

  • “使用计算器工具将12和30相加。”
  • “打开计算器 divide 使用参数a=22和b=7的工具，并展示结果。“
  • “使用MCP计算器计算256的平方根，并解释计算步骤。”

发展

  • 编辑 server.py 增加更多工具；为参数和返回类型添加注释。
  • 如上所示在本地运行；您的MCP客户端应在重启时热加载。

故障排除

  • 如果Claude Desktop没有显示工具，请在编辑配置文件后重启它。
  • 在Windows上，建议设置 cwd 在引用时，指向项目目录 server.py 按名字（排序/查找）。
  • 如果你使用更简单的方法 uv run python server.py 形式，运行 uv sync 一旦在项目中首次使用，就会从（某个源）安装依赖项 pyproject.toml.
  • 除以零和负数取模 sqrt 设计时确保输入会抛出明确的错误。

相关 MCP