🚀 基础数学 MCP 服务器
这是一个借助 FastMCP 框架 构建的 MCP 服务器，简单却功能强大。它支持加法、减法、乘法和除法等基本数学运算，可直接在 Claude Desktop 或任何 MCP 兼容环境中使用。
🚀 快速开始
本服务器支持基本的数学运算功能，如加法、减法、乘法和除法，可直接在 Claude Desktop 或任何 MCP 兼容环境中使用。
✨ 主要特性
- 基于 FastMCP 框架构建，简单强大。
- 支持基本数学运算，满足常见计算需求。
- 可在 Claude Desktop 或 MCP 兼容环境中直接使用。
📚 详细文档
什么是 MCP？
MCP (Model Context Protocol) 是由 Anthropic 开发的一个开源标准，允许外部工具、API 或脚本以结构化和交互式的方式暴露给大型语言模型（LLMs），例如 Claude。
通过 MCP，开发者可以：
- 构建可被语言模型访问的自定义工具。
- 使用 Python 脚本或微服务扩展 Claude 的功能。
- 通过
@tool()和@resource()装饰器共享结构化数据或自定义响应。
自定义 MCP 服务器是什么？
Custom MCP Server 是一个基于 Python 的服务，使用 mcp-server 库实现 MCP 规范。这些服务器：
- 定义可调用工具（
@tool）用于计算或自动化。 - 主机资源（
@resource）如文档或参考数据。 - 在本地或远程运行，并响应 MCP 客户端，例如 Claude Desktop。
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"对象中添加以下条目：
{
"mcpServers": {
"your-mcp-server-name": {
"command": "uv",
"args": [
"run",
"mcp-server"
]
}
}
}
⚠️ 注意事项
⚠️ 重要提示
- 确保
claude_desktop_config.json文件位于默认的配置路径中，通常为：~/Library/Application Support/Claude/- 如果你的 MCP 服务器暴露在公共网络上，请确保采取适当的安全措施，例如使用 HTTPS 和身份验证。
完成上述步骤后，你的基础数学 MCP 服务器应该可以正常运行并与 Claude Desktop 集成。