Basic Math MCP Server

🚀 基礎數學 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 集成。