🚀 MCP 服务器演示指南

本指南将详细介绍如何创建一个简单的模型上下文协议 (MCP) 服务器，并使用 MCP 检查器和 Claude Desktop 进行测试，帮助你快速上手 MCP 服务器的搭建与使用。

🚀 快速开始

先决条件

• uv - 一个极快的 Python 包和项目管理器，用 Rust 编写。

✨ 主要特性

本指南基于 modelcontextprotocol/python-sdk 的 README，增加了清晰性的说明，能让你更轻松地创建和测试 MCP 服务器。

📦 安装指南

1. 环境设置

uv init mcp-server-demo
cd mcp-server-demo

# 指定 Python 版本
echo "3.12" > .python-version

# 安装 Python 之前创建新的虚拟环境
uv venv 

# 激活虚拟环境
source .venv/bin/activate.fish

# 验证 Python 环境（检查是否使用正确的 Python 环境）
which python
path/to/mcp-server-demo/.venv/bin/python

# 安装 MCP 依赖项（添加到 pyproject.toml）
uv add "mcp[cli]"

# 验证 MCP 依赖项是否正确安装
uv tree

Resolved 28 packages in 3ms
mcp-server-demo v0.1.0
└── mcp[cli] v1.6.0
    ├── ...

💻 使用示例

基础用法

2. 创建一个简单的 MCP 服务器

# server.py
from mcp.server.fastmcp import FastMCP

# 创建一个 MCP 服务器
mcp = FastMCP("Demo")

# 添加一个加法工具
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# 添加一个动态问候资源
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

3. 使用 MCP 检查器进行测试

启动 MCP 检查器

uv run mcp dev server.py

启动 MCP 检查器...
⚙️ 代理服务器在端口 6277 上监听

测试 add 工具

1. 打开 MCP 检查器
2. 点击 "Connect"
3. 点击 "Tools" 标签
4. 在 "Tools" 标签内点击 "List Tools"

测试 get_greeting 资源

1. 打开 MCP 检查器
2. 点击 "Connect"
3. 点击 "Resources" 标签
4. 点击 "List Templates"
5. 找到 "get_greeting"
6. 输入一个名字（例如，"John"）
7. 点击 "Read Resources"

示例响应：

{
  "contents": [
    {
      "uri": "greeting://John",
      "mimeType": "text/plain",
      "text": "Hello, John!"
    }
  ]
}

4. 使用 Claude Desktop 进行测试

在 Claude Desktop 中安装 MCP 服务器

uv run mcp install server.py

[/dd/MM/YY HH:MM:SS] INFO     Added server 'Demo' to Claude config            claude.py:129
                     INFO     Successfully installed Demo in Claude app          cli.py:467

验证配置

# 对于 macOS/Linux
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

示例配置：

{
  "servers": [
    {
      "name": "Demo",
      "url": "http://localhost:5000"
    }
  ]
}

使用 MCP 服务器

1. 启动你的 MCP 服务器（例如，运行 python server.py）
2. 打开 Claude Desktop
3. 在 Claude 中输入问题，例如：
   • "What is 5 plus 3?"
   • "今天是几月？"

Claude Desktop 将使用 MCP 服务器提供的工具来回答这些问题。

📚 详细文档

常见问题

如何将自定义工具添加到 MCP 服务器？

• 在 server.py 中定义新工具，使用 @mcp.tool() 装饰器
• 示例：

@mcp.tool()
def greet(name: str) -> str:
    """Greet someone"""
    return f"Hello, {name}!"

如何在多个 MCP 服务器之间选择？

• 在配置文件中指定优先级顺序
• 示例：

{
  "servers": [
    {
      "name": "Primary",
      "url": "http://primary-server:5000"
    },
    {
      "name": "Secondary",
      "url": "http://secondary-server:5000"
    }
  ]
}

📖 参考资料

• 模型上下文协议 > 使用 LLMs 构建 MCP
• 模型上下文协议 > 调试
• 模型上下文协议 > 检查器