Simple MCP Example

数学MCP服务器

一种提供基本数学运算的模型上下文协议（MCP）服务器，带有Streamlit web客户端，便于交互。

特性

此MCP服务器公开了六个数学工具：

• 添加：将两个数字相加
• 乘：将两个数字相乘
• 减去：从第一个数字中减去第二个数字
• 分割：将第一个数字除以第二个数字（具有零除保护）
• 平方根：计算一个数字的平方根
• to_integer：将数字转换为整数

安装

此服务器使用Python和 uv 用于依赖性管理。确保你有 uv 安装：

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装依赖项：

uv sync

用法

Streamlit Web客户端（推荐）

与Math MCP服务器交互的最简单方法是通过Streamlit web界面：

uv run streamlit run app.py

这将启动web服务器（通常在http://localhost:8501)您可以在哪里：

• 从下拉菜单中选择数学运算
• 在用户友好的界面中输入数字
• 立即查看显示的结果
• 获取无效操作的有用错误消息

使用克劳德桌面

将此配置添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "math": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/Simple MCP Example",
        "run",
        "math-mcp-server"
      ]
    }
  }
}

替换 /ABSOLUTE/PATH/TO/Simple MCP Example 带有此项目目录的实际路径。

使用VS代码

服务器已在中配置 .vscode/mcp.json支持MCP的.VS Code将自动检测并使用此配置。

MCP检验员测试

您可以使用MCP检查器测试服务器：

npx @modelcontextprotocol/inspector uv --directory . run math-mcp-server

可用工具

添加

将两个数字相加。

参数：

• a （number）：要添加的第一个数字
• b （number）：要添加的第二个数字

例子： add(5, 3) 回报 5 + 3 = 8

乘

将两个数字相乘。

参数：

• a （number）：第一个要相乘的数字
• b （number）：要相乘的第二个数字

例子： multiply(4, 7) 回报 4 × 7 = 28

减去

从第一个数字中减去第二个数字。

参数：

• a （数字）：要减去的数字
• b （数字）：要减去的数字

例子： subtract(10, 4) 回报 10 - 4 = 6

分割

将第一个数字除以第二个数字。

参数：

• a （数字）：要除的数字（分子）
• b （数字）：除以（分母）的数字

例子： divide(20, 4) 回报 20 ÷ 4 = 5

注： 除以零返回错误消息。

平方根

计算一个数字的平方根。

参数：

• a （number）：计算平方根的数字

例子： sqrt(16) 回报 √16 = 4.0

注： 负数返回错误消息。

to_integer

将数字（包括浮点数）转换为整数。处理负数和十进制值等边缘情况。

参数：

• a （number）：要转换为整数的数字

示例：

• to_integer(3.7) 回报 3.7 → 3
• to_integer(-5.9) 回报 -5.9 → -5
• to_integer(42) 回报 42 → 42

发展

Python客户端模块

这 client.py 模块提供Python API，用于以编程方式与MCP服务器交互：

from client import perform_operation

# Perform operations
result = perform_operation("add", 5, 3)
print(result)  # "5.0 + 3.0 = 8.0"

result = perform_operation("sqrt", 16)
print(result)  # "√16.0 = 4.0"

直接运行

要直接运行服务器，请执行以下操作：

uv run math-mcp-server

运行Streamlit客户端

要启动web界面，请执行以下操作：

uv run streamlit run app.py

项目结构

.
├── server.py             # Main MCP server implementation
├── client.py             # Python client module for MCP communication
├── app.py                # Streamlit web frontend
├── pyproject.toml        # Project dependencies and configuration
└── README.md            # This file

许可证

麻省理工学院