创建自定义服务器指南

开始构建你自己的服务器，用于Claude桌面版和其他客户端。

在此教程中，我们将构建一个简单的MCP计算器服务器，并将其连接到主机Claude桌面版。

什么是MCP？

MCP 指的是 模型上下文协议 — 它是一种允许开发者扩展AI助手（如Claude）功能的协议。

• 可以理解为给你的AI助手 增加额外能力。
• 这些服务器公开工具或功能，助手可以在对话期间使用这些工具和功能。
• 例如：你可以构建天气服务器、计算器、财务管理助手，或者任何你能想象的功能。

我们将要构建的内容

我们将构建一个提供四个工具的服务器：add、subtract、multiply 和 divide。然后我们将该服务器连接到MCP主机（在此示例中为Claude桌面版）。

核心概念

• 资源：允许助手访问外部数据或服务。
• 工具：扩展助手的功能。
• 提示：自定义助手的交互方式。

此次重点放在 工具 上，因为我们将创建一个计算器工具。

先决条件

• 基础 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桌面版中配置计算器服务器

要在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桌面版中使用计算器服务器进行基本的算术运算！