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 運行時下載