Create MCP Server

🚀 创建自定义服务器

本项目可帮助你构建自己的服务器，以便在Claude for Desktop和其他客户端中使用。通过构建自定义服务器，你能够为AI助手扩展功能，满足多样化的需求。

🚀 快速开始

在这个教程里，我们会构建一个简单的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官方文档。