Create MCP Server

🚀 创建自定义服务器

本项目可帮助你构建自己的服务器，使其能在Claude for Desktop及其他客户端中使用。通过此项目，你能扩展AI助手的功能，为其增添额外的工具和服务。

🚀 快速开始

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

✨ 主要特性

MCP 即 模型上下文协议，它允许开发者扩展AI助手（如Claude）的功能，例如自定义工具和服务器。其特性如下：

• 能为AI助手 增加额外功能。
• 服务器可向助手在对话期间提供可调用的功能。
• 可构建如天气服务器、计算器、财务助手等各种类型的服务器。

我们要构建的内容

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

⚠️ 重要提示

服务器可以连接到任何客户端，我们选择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官方文档