Basic Math MCP Server Q8t

🚀 基础数学 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 服务器，请按照以下步骤操作：

1. 打开 claudia.json 文件（通常位于用户主目录下的 .config/claudia/ 目录中）。
2. 添加或修改如下内容：

   {
     "mcpServers": [
       {
         "name": "math_server",
         "url": "http://localhost:8000"
       }
     ]
   }
   

3. 如果您已有其他服务器，请确保新配置与现有条目正确分隔。

工具和资源详情

工具

• add(a, b) – 返回两个数字的和。
• subtract(a, b) – 返回从 a 中减去 b 的结果。
• multiply(a, b) – 返回 a 和 b 的乘积。
• divide(a, b) – 返回 a 除以 b 的结果，支持处理除零异常。

资源

• math_help() – 返回数学运算的示例和文档链接。

🔗 有用的链接

• FastMCP 框架
• Claude Desktop 文档
• uv 运行时下载