🚀 基础数学 MCP 服务器
这是一个简单且强大的 MCP 服务器，它基于 FastMCP 框架 构建。该服务器支持加法、减法、乘法和除法等基本数学运算，可直接在 Claude Desktop 或任何 MCP 兼容环境中使用。
🚀 快速开始
本项目是一个最小化但功能完整的 MCP 服务器，能提供基础算术功能。在使用前，你需要完成一些准备工作并进行安装。
✨ 主要特性
MCP 相关特性
- MCP 标准对接：MCP（模型上下文协议）是由 Anthropic 开发的开源标准，此服务器遵循该标准，允许外部工具、API 或脚本以结构化和交互式的方式与大型语言模型（LLMs）如 Claude 对接。
- 功能扩展：开发者可借助 MCP 构建可被语言模型访问的自定义工具，使用 Python 脚本或微服务扩展 Claude 的功能，还能通过
@tool()和@resource()装饰器共享结构化数据或自定义响应。
服务器特性
- 自定义工具与资源：定义了可调用工具（
@tool）用于计算或自动化操作，如add(a, b)、subtract(a, b)等；还提供了主机资源（@resource），如math_help()可返回数学运算的示例和文档链接。 - 低延迟集成：实现了低延迟、安全且上下文化的语言模型与代码之间的集成。
📦 安装指南
先决条件
在继续之前，请确保您满足以下要求：
- 安装 Python 3.6 或更高版本。
- 安装 Claude Desktop 并配置 API 密钥。
- 熟悉命令行界面（CLI）操作。
安装步骤
第一步：安装 uv
在终端中运行以下命令以安装 uv 运行时：
# 在 macOS/Linux 上使用以下命令：
curl -o /usr/local/bin/uv https://github.com/samth/uv/releases/download/v1.0.0/uv-macos-x86_64 && chmod +x /usr/local/bin/uv
# 在 Windows 上使用以下命令（需要WSL支持）：
powershell.exe (iwr https://github.com/samth/uv/releases/download/v1.0.0/uv-win-x86_64).Content | Out-File -Path %ProgramFiles%\uv\uv.exe
第二步：安装和运行 MCP 服务器
使用 uv 运行时来安装和启动服务器：
uv run mcp_server.py
💻 使用示例
基础用法
要测试 MCP 服务器的功能，可以直接在 Claude Desktop 中使用以下查询：
调用 add(2, 3)
高级用法
要获取数学运算的帮助信息，请调用：
调用 math_help()
该函数将返回包含示例和文档链接的 JSON 格式响应。
📚 详细文档
与 Claude Desktop 的集成
要使 Claude Desktop 识别您的 MCP 服务器，请按照以下步骤操作：
- 打开
claudia.json文件（通常位于用户主目录下的.config/claudia/目录中）。 - 添加或修改如下内容：
{ "mcpServers": [ { "name": "math_server", "url": "http://localhost:8000" } ] } - 如果您已有其他服务器，请确保新配置与现有条目正确分隔。
工具和资源详情
工具
add(a, b)– 返回两个数字的和。subtract(a, b)– 返回从a中减去b的结果。multiply(a, b)– 返回a和b的乘积。divide(a, b)– 返回a除以b的结果，支持处理除零异常。
资源
math_help()– 返回数学运算的示例和文档链接。