创建自定义服务器

开始构建自己的服务器以在Claude for Desktop和其他客户端中使用。

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

什么是MCP？

MCP代表模型上下文协议——它是一种协议，允许开发者扩展AI助手（如Claude）的功能（例如自定义工具和服务器）。

• 可以将其视为给您的AI助手增加额外功能。
• 这些服务器向助手在对话期间可以调用的功能或功能提供功能。
• 例如：您可以构建天气服务器、计算器、财务助手或其他任何您能想象的内容。

我们要构建的内容

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

注意：服务器可以连接到任何客户端。我们选择Claude for Desktop作为演示。

系统要求

• 操作系统：MacOS、Linux或Windows
• Python：3.6+
• uv工具：用于运行服务器

安装指南

MacOS/Linux

# 克隆仓库
git clone https://github.com/your-repository.git
cd calculator-server

# 创建并激活虚拟环境
python -m venv env
source env/bin/activate  # MacOS/Linux

Windows

# 克隆仓库
git clone https://github.com/your-repository.git
cd calculator-server

# 创建并激活虚拟环境
python -m venv env
env\Scripts\activate  # Windows

项目结构

calculator-server/
├── calculator.py       # 主服务器文件
└── README.md          # 项目说明

运行服务器

MacOS/Linux

uv --directory ./ run calculator.py

Windows

uv --directory .\ run calculator.py

配置Claude for Desktop

要使计算器服务器在Claude for Desktop中可用，您需要编辑Claude的配置文件。

MacOS/Linux

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

Windows

code $env:AppData\Claude\claude_desktop_config.json

在该文件中，添加以下内容：

MacOS/Linux

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

Windows

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

注意：请将/path/to/uv替换为实际的uv可执行文件路径。

保存文件后，重新启动Claude for Desktop即可看到新的计算器工具。

使用示例

加法

claude> add 10 20
30

减法

claude> subtract 50 30
20

乘法

claude> multiply 10 5
50

除法

claude> divide 100 20
5

更多信息

MCP官方文档