Simple Calculator MCP Server

🚀 創建自定義服務器指南

本指南將指導你構建自己的服務器，用於Claude桌面版和其他客戶端。通過本教程，你將學會構建一個簡單的MCP計算器服務器，並將其連接到Claude桌面版主機。

✨ 主要特性

• MCP協議擴展：利用模型上下文協議（MCP）擴展Claude等AI助手的功能。
• 自定義工具創建：可以構建各種工具，如天氣服務器、計算器、財務管理助手等。
• 多系統支持：支持在MacOS、Linux和Windows系統上創建和配置服務器。

📦 安裝指南

先決條件

• 具備基礎的Python編程經驗。
• 對大型語言模型（LLM）有基本瞭解。
• 系統要求：
  • Python 3.8 或更高版本。
  • 參考MCP官方文檔：MCP官方文檔

創建項目並初始化環境

MacOS/Linux

# 安裝uv CLI 工具（如果尚未安裝）
brew install model-context-protocol/protobuf/protobuf-cpp

# 初始化新項目
mkdir calculator && cd calculator

Windows

# 安裝uv CLI 工具（如果尚未安裝）
# 需要從MCP官方網站下載並安裝Windows版本的uv工具。

# 初始化新項目
mkdir calculator && cd calculator

💻 使用示例

基礎用法

實現代碼

以下是實現計算器服務器的完整代碼：

# 導入庫和模塊
from fastapi import FastAPI
from typing import Optional, Union
import uvicorn

# 定義工具
app = FastAPI()

@app.get("/calculate")
async def calculate(
    expression: str,
    error_handling: Optional[bool] = True,
    simplify: Optional[bool] = True
) -> Union[str, dict]:
    """Calculate a mathematical expression."""
    
    try:
        result = eval(expression)
        if simplify:
            return f"{expression} 的結果是 {result}"
        return str(result)
    except Exception as e:
        if error_handling:
            return {"error": str(e)}
        raise

# 啟動服務器
if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)

配置Claude桌面版

MacOS/Linux

編輯配置文件：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

將以下內容添加到 mcpServers 鍵下：

{
    "mcpServers": {
        "calculator": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/calculator",
                "run",
                "calculator.py"
            ]
        }
    }
}

Windows

編輯配置文件：

code $env:AppData/Claude/claude_desktop_config.json

將以下內容添加到 mcpServers 鍵下：

{
    "mcpServers": {
        "calculator": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\calculator",
                "run",
                "calculator.py"
            ]
        }
    }
}

⚠️ 重要提示

請確保將 /ABSOLUTE/PATH/TO/PARENT/FOLDER 替換為你的實際路徑。

保存文件後，重啟Claude桌面版，即可在Claude桌面版中使用計算器服務器進行基本的算術運算。

📚 詳細文檔

什麼是MCP？

MCP 即 模型上下文協議，它是一種允許開發者擴展AI助手（如Claude）功能的協議。可以理解為給AI助手 增加額外能力，這些服務器公開工具或功能，助手可以在對話期間使用。例如，你可以構建天氣服務器、計算器、財務管理助手，或者任何你能想象的功能。

我們將要構建的內容

我們將構建一個提供四個工具的服務器：add、subtract、multiply 和 divide，然後將該服務器連接到MCP主機（在此示例中為Claude桌面版）。

核心概念

• 資源：允許助手訪問外部數據或服務。
• 工具：擴展助手的功能。
• 提示：自定義助手的交互方式。

此次重點放在 工具 上，因為我們將創建一個計算器工具。