MCP 服务器

MCP Server Demo

sotayamashita

开发者工具

访问服务器

README

MCP 服务器演示

前提条件

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

概述

本指南将引导您创建一个简单的模型上下文协议 (MCP) 服务器，并使用 MCP Inspector 和 Claude Desktop 对其进行测试。内容基于 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 环境）
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 Inspector 进行测试

启动 MCP Inspector

uv run mcp dev server.py

Starting MCP inspector...
⚙️ Proxy server listening on port 6277

测试 `add` 工具

打开 MCP Inspector
点击 "Connect"
点击 "Tools" 选项卡
点击 "Tools" 选项卡内的 "List Tools"

测试 `get_greeting` 资源

打开 MCP Inspector
点击 "Connect"
点击 "Resources" 选项卡
点击 "List Templates"
找到 "get_greeting"
输入一个名字 (例如, "John")
点击 "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

验证配置

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

示例配置:

{
    "mcpServers": {
        "Demo": {
            "command": "/absolute/path/to/uv",
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "/absolute/path/to/mcp-server-demo/server.py"
            ]
        }
    }
}