MCP Server 开发实战：手写一个让 Claude Code 接入私有数据的服务器

# macOS / Linux
# 海外用户直连 python.org，国内用户用华为云镜像
# 以下以 Ubuntu/Debian 为例，其他系统类似
sudo apt update && sudo apt install python3 python3-pip -y

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

mkdir mcp-server-demo && cd mcp-server-demo

uv init

# 推荐方式（uv，带 mcp CLI 工具）
uv add "mcp[cli]"

# 或 pip 方式（国内用户加清华镜像加速）
pip install "mcp[cli]" -i https://pypi.tuna.tsinghua.edu.cn/simple

# server.py
from mcp.server import MCPServer

# 创建一个 MCP Server 实例，名字叫 "Demo"
mcp = MCPServer("Demo")


@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers."""
    return a + b


@mcp.resource("greeting://{name}")
def greeting(name: str) -> str:
    """Greet someone by name."""
    return f"Hello, {name}!"

uv run mcp dev server.py

{
  "mcpServers": {
    "demo": {
      "command": "uv",
      "args": ["run", "mcp", "run", "server.py", "--transport", "stdio"]
    }
  }
}

{
  "mcpServers": {
    "demo": {
      "command": "python3",
      "args": ["-m", "mcp", "run", "server.py", "--transport", "stdio"]
    }
  }
}

claude

export ANTHROPIC_API_KEY="你的云间API-Key"
export ANTHROPIC_BASE_URL="https://cloudzone-api.cyou/v1"

# init_db.py
import sqlite3

conn = sqlite3.connect("company.db")
cursor = conn.cursor()

# 创建员工表
cursor.execute("""
CREATE TABLE IF NOT EXISTS employees (
    id INTEGER PRIMARY KEY,
    name TEXT NOT NULL,
    department TEXT NOT NULL,
    salary INTEGER NOT NULL
)
""")

# 插入几条测试数据
employees = [
    (1, "张三", "技术部", 25000),
    (2, "李四", "市场部", 18000),
    (3, "王五", "技术部", 30000),
    (4, "赵六", "人事部", 15000),
    (5, "钱七", "市场部", 22000),
]
cursor.executemany("INSERT OR REPLACE INTO employees VALUES (?, ?, ?, ?)", employees)
conn.commit()
conn.close()

print("数据库初始化完成：company.db")

python3 init_db.py

# mcp_company_server.py
import sqlite3
import httpx
from mcp.server import MCPServer

mcp = MCPServer("Company Data Server")


# ========== Tool 1: SQL 查询工具 ==========
@mcp.tool()
def sql_query(sql: str) -> str:
    """Execute a SQL query on the company SQLite database.
    Use this to query employee information, department stats, etc.
    Only SELECT queries are allowed for safety.
    """
    # 安全检查：只允许 SELECT 语句
    sql_stripped = sql.strip().upper()
    if not sql_stripped.startswith("SELECT"):
        return "Error: Only SELECT queries are allowed for safety."

    try:
        conn = sqlite3.connect("company.db")
        conn.row_factory = sqlite3.Row  # 让结果可以用列名访问
        cursor = conn.cursor()
        cursor.execute(sql)
        rows = cursor.fetchall()
        conn.close()

        if not rows:
            return "Query returned no results."

        # 格式化为易读的文本
        columns = [desc[0] for desc in cursor.description]
        result_lines = [" | ".join(columns)]
        result_lines.append("-" * len(result_lines[0]))
        for row in rows:
            result_lines.append(" | ".join(str(row[col]) for col in columns))

        return "\n".join(result_lines)
    except Exception as e:
        return f"Query error: {str(e)}"


# ========== Tool 2: 内部 API 调用工具 ==========
@mcp.tool()
async def call_internal_api(
    endpoint: str,
    method: str = "GET",
    body: str = "",
) -> str:
    """Call an internal company API endpoint.
    endpoint: API path, e.g. '/api/v1/orders/today'
    method: HTTP method, 'GET' or 'POST'
    body: JSON body for POST requests
    """
    BASE_URL = "https://api.internal-company.com"

    async with httpx.AsyncClient(timeout=10.0) as client:
        try:
            if method.upper() == "GET":
                response = await client.get(f"{BASE_URL}{endpoint}")
            elif method.upper() == "POST":
                response = await client.post(
                    f"{BASE_URL}{endpoint}",
                    content=body,
                    headers={"Content-Type": "application/json"},
                )
            else:
                return f"Error: Unsupported method '{method}'. Use GET or POST."

            return f"Status: {response.status_code}\n{response.text[:2000]}"
        except Exception as e:
            return f"API call failed: {str(e)}"


# ========== Resource: 数据库结构 ==========
@mcp.resource("db://schema")
def get_db_schema() -> str:
    """Return the database schema so AI can understand available tables."""
    conn = sqlite3.connect("company.db")
    cursor = conn.cursor()
    cursor.execute(
        "SELECT sql FROM sqlite_master WHERE type='table' AND name='employees'"
    )
    row = cursor.fetchone()
    conn.close()

    if row:
        return f"Table: employees\n{row[0]}"
    return "No table found. Run init_db.py first."

# uv 方式
uv add httpx

# pip 方式（国内用户加清华镜像）
pip install httpx -i https://pypi.tuna.tsinghua.edu.cn/simple

uv run mcp dev mcp_company_server.py

SELECT * FROM employees WHERE department = '技术部'

{
  "mcpServers": {
    "company-data": {
      "command": "uv",
      "args": ["run", "mcp", "run", "mcp_company_server.py", "--transport", "stdio"]
    }
  }
}

pip install "mcp[cli]" httpx -i https://pypi.tuna.tsinghua.edu.cn/simple
python3 init_db.py

mcp run mcp_company_server.py --transport streamable-http --port 8000

{
  "mcpServers": {
    "company-data": {
      "url": "https://your-agent.cloudzone-api.cyou/mcp",
      "transport": "streamable-http"
    }
  }
}

import os

DB_PASSWORD = os.environ.get("DB_PASSWORD", "")
if not DB_PASSWORD:
    raise RuntimeError("DB_PASSWORD environment variable not set")

{
  "mcpServers": {
    "company-data": {
      "command": "uv",
      "args": ["run", "mcp", "run", "mcp_company_server.py", "--transport", "stdio"],
      "env": {
        "DB_PASSWORD": "your-secret-password"
      }
    }
  }
}

pip install "mcp[cli]" httpx -i https://pypi.tuna.tsinghua.edu.cn/simple

pip install "mcp[cli]" httpx -i https://mirrors.aliyun.com/pypi/simple

chmod +x setup-mcp-demo.sh
./setup-mcp-demo.sh

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
.\setup-mcp-demo.ps1

#!/usr/bin/env bash
# ============================================================
#  MCP Server 开发实战 一键脚本（macOS / Linux / WSL）
#  公开源码，欢迎审查 —— 不放心可先复制给 AI 判断
#  默认配置：云间 API 中转站（https://cloudzone-api.cyou/）
#  功能：检测网络 → 装 Python 依赖(uv) → 生成示例 server.py → 启动 MCP Inspector
# ============================================================

set -u

CLOUDZONE_URL="https://cloudzone-api.cyou"
CLOUDZONE_API_BASE="https://cloudzone-api.cyou/v1"

GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; CYAN='\033[0;36m'; NC='\033[0m'
info()  { echo -e "${GREEN}[INFO]${NC} $1"; }
warn()  { echo -e "${YELLOW}[WARN]${NC} $1"; }
error() { echo -e "${RED}[ERROR]${NC} $1"; }
step()  { echo -e "${CYAN}[STEP]${NC} $1"; }
fail()  { error "$1"; error "脚本无法继续。请把以上报错复制给 AI 或贴到 issue 求助。"; exit 1; }

# ---------- 第 0 步：检测网络环境（国内 / 国外）----------
detect_network() {
  step "检测网络环境（国内 / 国外）..."
  if curl -fsI --max-time 6 "https://pypi.org" >/dev/null 2>&1; then
    info "可直连 pypi.org，判定为海外网络"
    echo "overseas"
  else
    warn "无法直连 pypi.org，判定为国内网络环境，将使用清华/阿里 PyPI 镜像"
    echo "domestic"
  fi
}

# ---------- 第 1 步：检查 Python ≥ 3.10 ----------
check_python() {
  step "检查 Python 环境（需 3.10+）..."
  if ! command -v python3 >/dev/null 2>&1; then
    warn "未检测到 python3。请先安装 Python 3.10+（https://www.python.org/downloads/）"
    fail "python3 未安装"
  fi
  local PY_VER
  PY_VER=$(python3 -c 'import sys;print(f"{sys.version_info.major}.{sys.version_info.minor}")' 2>/dev/null || echo "0.0")
  local MAJOR MINOR
  MAJOR="${PY_VER%%.*}"
  MINOR="${PY_VER#*.}"
  if [ "$MAJOR" -lt 3 ] || { [ "$MAJOR" -eq 3 ] && [ "$MINOR" -lt 10 ]; }; then
    fail "Python 版本 $PY_VER 低于 3.10，请升级（MCP Python SDK 要求 3.10+）"
  fi
  info "Python $PY_VER 已就绪"
}

# ---------- 第 2 步：安装 uv（推荐方式装 mcp） ----------
install_uv() {
  local net="$1"
  step "安装 uv（Python 包管理器，推荐）..."
  if command -v uv >/dev/null 2>&1; then
    info "uv 已安装：$(uv --version 2>/dev/null || echo uv)"
    return 0
  fi
  if [ "$net" = "domestic" ]; then
    info "国内网络：用清华 PyPI 镜像装 uv"
    pip3 install --user -i https://pypi.tuna.tsinghua.edu.cn/simple uv >/dev/null 2>&1 \
      || pip3 install --user -i https://mirrors.aliyun.com/pypi/simple/ uv >/dev/null 2>&1 \
      || fail "uv 安装失败（pip3 镜像均不通）"
  else
    info "海外网络：官方脚本装 uv"
    curl -LsSf https://astral.sh/uv/install.sh -o /tmp/uv_install.sh 2>/dev/null
    [ -s /tmp/uv_install.sh ] && sh /tmp/uv_install.sh >/dev/null 2>&1 || pip3 install --user uv >/dev/null 2>&1 || fail "uv 安装失败"
    rm -f /tmp/uv_install.sh
    export PATH="$HOME/.local/bin:$HOME/.cargo/bin:$PATH"
  fi
  command -v uv >/dev/null 2>&1 || fail "uv 安装后仍不在 PATH，请手动装：pip3 install uv"
  info "uv 安装完成"
}

# ---------- 第 3 步：创建项目目录 + 示例 server.py ----------
create_server() {
  step "创建示例 MCP Server（add + greeting 两个工具）..."
  local DIR="$HOME/mcp-demo"
  mkdir -p "$DIR"
  cd "$DIR" || fail "无法进入 $DIR"

  # 初始化项目（国内用镜像源）
  if [ ! -f "pyproject.toml" ]; then
    info "初始化 uv 项目..."
    if [ "${1:-overseas}" = "domestic" ]; then
      UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple" uv init --no-readme >/dev/null 2>&1 \
        || UV_INDEX_URL="https://mirrors.aliyun.com/pypi/simple/" uv init --no-readme >/dev/null 2>&1
    else
      uv init --no-readme >/dev/null 2>&1
    fi
  fi

  info "安装 mcp[cli]..."
  if [ "${1:-overseas}" = "domestic" ]; then
    uv add "mcp[cli]" --index-url https://pypi.tuna.tsinghua.edu.cn/simple >/dev/null 2>&1 \
      || uv add "mcp[cli]" --index-url https://mirrors.aliyun.com/pypi/simple/ >/dev/null 2>&1 \
      || fail "mcp 安装失败（PyPI 镜像均不通）"
  else
    uv add "mcp[cli]" >/dev/null 2>&1 || fail "mcp 安装失败（pypi.org 不通？）"
  fi

  cat > server.py <<'PYEOF'
"""示例 MCP Server：add（加法）+ greeting（问候）两个工具。

启动后用 `mcp dev` 打开 Inspector 测试，或在 Claude Code 里把本文件作为 MCP server 接入。
"""
from mcp.server import MCPServer

mcp = MCPServer("Demo")


@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers."""
    return a + b


@mcp.resource("greeting://{name}")
def greeting(name: str) -> str:
    """Greet someone by name."""
    return f"Hello, {name}!"


if __name__ == "__main__":
    mcp.run()
PYEOF
  info "示例 server.py 已生成：$DIR/server.py"
  echo "$DIR"
}

# ---------- 第 4 步：（可选）引导配置 CZ API Key 接入 Claude Code ----------
setup_api_key() {
  echo ""
  echo "----------------------------------------"
  echo "想让 MCP Server 真正接入 Claude Code 跑起来？"
  echo "Claude Code 需调用 Anthropic API。国内直连 anthropic.com 受限，"
  echo "推荐用云间 API 中转站："
  echo "  · 价格低至官方两折，国内直连无需翻墙"
  echo "  · 支持 90+ 模型（Claude/GPT/DeepSeek），香港节点延迟低"
  echo ""
  echo "是否现在跳转注册并获取 API Key？"
  echo "  Y - 立即跳转至 ${CLOUDZONE_URL}"
  echo "  N - 我已有 Key，自行输入"
  read -r -p "请选择 [Y/N]: " choice

  local API_KEY=""
  if [ "${choice:-N}" = "Y" ] || [ "${choice:-N}" = "y" ]; then
    info "正在打开浏览器..."
    if command -v xdg-open >/dev/null 2>&1; then
      xdg-open "$CLOUDZONE_URL" >/dev/null 2>&1
    elif command -v open >/dev/null 2>&1; then
      open "$CLOUDZONE_URL" >/dev/null 2>&1
    else
      warn "无法自动打开浏览器，请手动访问：$CLOUDZONE_URL"
    fi
    echo "注册后在「我的 API Key」页面复制 Key（以 sk- 开头）。"
    read -r -p "粘贴你的 API Key: " API_KEY
  else
    # 关闭回显，避免 Key 明文留在终端滚动区
    read -r -s -p "请输入你的 API Key (sk-...): " API_KEY
    echo
  fi

  if [ -z "${API_KEY:-}" ]; then
    warn "未输入 API Key，跳过 Claude Code 配置。可稍后手动 export ANTHROPIC_API_KEY。"
    return 0
  fi

  # 写入 shell 配置（让 Claude Code 进程能读到）
  local RC=""
  [ -f "$HOME/.zshrc" ] && RC="$HOME/.zshrc"
  [ -f "$HOME/.bashrc" ] && [ -z "$RC" ] && RC="$HOME/.bashrc"
  if [ -n "$RC" ]; then
    # 去掉旧的 CZ 配置
    sed -i '/# CZ API config (cloudzone)/,/^export ANTHROPIC_BASE_URL=/d' "$RC" 2>/dev/null
    {
      echo "# CZ API config (cloudzone) - added by mcp-demo setup"
      echo "export ANTHROPIC_API_KEY=\"${API_KEY}\""
      echo "export ANTHROPIC_BASE_URL=\"${CLOUDZONE_API_BASE}\""
    } >> "$RC"
    info "已写入 $RC：ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL"
    warn "新开终端才会生效。当前终端请手动执行：export ANTHROPIC_API_KEY=... ANTHROPIC_BASE_URL=$CLOUDZONE_API_BASE"
  else
    warn "未找到 .zshrc/.bashrc，请手动设置两个环境变量：ANTHROPIC_API_KEY / ANTHROPIC_BASE_URL"
  fi
}

# ---------- 主流程 ----------
main() {
  echo "============================================"
  echo "  MCP Server 开发实战 一键部署"
  echo "  macOS / Linux / WSL 版"
  echo "============================================"
  echo ""

  local NET
  NET=$(detect_network)

  check_python
  install_uv "$NET"
  local DIR
  DIR=$(create_server "$NET")

  echo ""
  step "启动 MCP Inspector 测试..."
  echo "示例 server 在：$DIR/server.py"
  echo "运行下面命令打开 Inspector（浏览器交互界面）："
  echo "  cd $DIR && uv run mcp dev server.py"
  echo ""
  echo "在 Inspector 里调用 add(1, 2) 应得 3，greeting('World') 返回 'Hello, World!'"
  echo ""

  # 可选：引导 CZ Key 接入 Claude Code
  read -r -p "是否现在配置云间 API Key 接入 Claude Code？[Y/N] " want_key
  if [ "${want_key:-N}" = "Y" ] || [ "${want_key:-N}" = "y" ]; then
    setup_api_key
  fi

  echo ""
  info "全部完成！详细说明见博客：https://cleanresolver.com/tutorials/mcp-server-develop-guide/"
  echo "完整脚本源码已在文末公开，也可从 /scripts/setup-mcp-demo.sh 下载"
}

main "$@"

# ============================================================
#  MCP Server 开发实战 一键脚本（Windows PowerShell）
#  公开源码，欢迎审查 —— 不放心可先复制给 AI 判断
#  默认配置：云间 API 中转站（https://cloudzone-api.cyou/）
#  功能：检测网络 → 装 Python 依赖(uv) → 生成示例 server.py → 启动 MCP Inspector
# ============================================================

$ErrorActionPreference = "Stop"
$CLOUDZONE_URL = "https://cloudzone-api.cyou"
$CLOUDZONE_API_BASE = "https://cloudzone-api.cyou/v1"

function Write-Info($m) { Write-Host "[INFO] $m" -ForegroundColor Green }
function Write-Warn($m) { Write-Host "[WARN] $m" -ForegroundColor Yellow }
function Write-Err($m)   { Write-Host "[ERROR] $m" -ForegroundColor Red }
function Write-Step($m)  { Write-Host "[STEP] $m" -ForegroundColor Cyan }
function Fail($m) { Write-Err $m; Write-Err "脚本无法继续。请把以上报错复制给 AI 或贴到 issue 求助。"; exit 1 }

# ---------- 第 0 步：检测网络环境（国内 / 国外）----------
function Detect-Network {
    Write-Step "检测网络环境（国内 / 国外）..."
    try {
        $r = Invoke-WebRequest -Uri "https://pypi.org" -Method Head -TimeoutSec 6 -UseBasicParsing
        Write-Info "可直连 pypi.org，判定为海外网络"
        return "overseas"
    } catch {
        Write-Warn "无法直连 pypi.org，判定为国内网络环境，将使用清华/阿里 PyPI 镜像"
        return "domestic"
    }
}

# ---------- 第 1 步：检查 Python ≥ 3.10 ----------
function Check-Python {
    Write-Step "检查 Python 环境（需 3.10+）..."
    $py = Get-Command python -ErrorAction SilentlyContinue
    if (-not $py) { $py = Get-Command python3 -ErrorAction SilentlyContinue }
    if (-not $py) {
        Write-Warn "未检测到 python。请先安装 Python 3.10+（https://www.python.org/downloads/）"
        Fail "python 未安装"
    }
    $ver = & $py.Source -c "import sys;print(f'{sys.version_info.major}.{sys.version_info.minor}')" 2>$null
    if (-not $ver) { Fail "无法获取 Python 版本" }
    $parts = $ver.Split('.')
    $major = [int]$parts[0]; $minor = [int]$parts[1]
    if ($major -lt 3 -or ($major -eq 3 -and $minor -lt 10)) {
        Fail "Python 版本 $ver 低于 3.10，请升级（MCP Python SDK 要求 3.10+）"
    }
    Write-Info "Python $ver 已就绪"
    return $py.Source
}

# ---------- 第 2 步：安装 uv ----------
function Install-Uv($net) {
    Write-Step "安装 uv（Python 包管理器，推荐）..."
    $uv = Get-Command uv -ErrorAction SilentlyContinue
    if ($uv) { Write-Info "uv 已安装：$(uv --version)"; return }

    if ($net -eq "domestic") {
        Write-Info "国内网络：用清华 PyPI 镜像装 uv"
        & python -m pip install --user -i https://pypi.tuna.tsinghua.edu.cn/simple uv 2>$null
        if (-not (Get-Command uv -ErrorAction SilentlyContinue)) {
            & python -m pip install --user -i https://mirrors.aliyun.com/pypi/simple/ uv 2>$null
        }
    } else {
        Write-Info "海外网络：用官方 PyPI 装 uv"
        & python -m pip install --user uv 2>$null
    }
    if (-not (Get-Command uv -ErrorAction SilentlyContinue)) {
        Fail "uv 安装失败。请手动执行：python -m pip install --user uv"
    }
    Write-Info "uv 安装完成"
}

# ---------- 第 3 步：创建项目目录 + 示例 server.py ----------
function Create-Server($net, $pyExe) {
    Write-Step "创建示例 MCP Server（add + greeting 两个工具）..."
    $dir = Join-Path $env:USERPROFILE "mcp-demo"
    New-Item -ItemType Directory -Force -Path $dir | Out-Null
    Set-Location $dir

    if (-not (Test-Path "pyproject.toml")) {
        Write-Info "初始化 uv 项目..."
        if ($net -eq "domestic") {
            $env:UV_INDEX_URL = "https://pypi.tuna.tsinghua.edu.cn/simple"
            & uv init --no-readme 2>$null
            if (-not $?) { $env:UV_INDEX_URL = "https://mirrors.aliyun.com/pypi/simple/"; & uv init --no-readme 2>$null }
        } else {
            & uv init --no-readme 2>$null
        }
    }

    Write-Info "安装 mcp[cli]..."
    if ($net -eq "domestic") {
        & uv add "mcp[cli]" --index-url https://pypi.tuna.tsinghua.edu.cn/simple 2>$null
        if (-not $?) { & uv add "mcp[cli]" --index-url https://mirrors.aliyun.com/pypi/simple/ 2>$null }
        if (-not $?) { Fail "mcp 安装失败（PyPI 镜像均不通）" }
    } else {
        & uv add "mcp[cli]" 2>$null
        if (-not $?) { Fail "mcp 安装失败（pypi.org 不通？）" }
    }

    $serverPy = @'
"""示例 MCP Server：add（加法）+ greeting（问候）两个工具。

启动后用 `mcp dev` 打开 Inspector 测试，或在 Claude Code 里把本文件作为 MCP server 接入。
"""
from mcp.server import MCPServer

mcp = MCPServer("Demo")


@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers."""
    return a + b


@mcp.resource("greeting://{name}")
def greeting(name: str) -> str:
    """Greet someone by name."""
    return f"Hello, {name}!"


if __name__ == "__main__":
    mcp.run()
'@
    Set-Content -Path (Join-Path $dir "server.py") -Value $serverPy -Encoding UTF8
    Write-Info "示例 server.py 已生成：$dir\server.py"
    return $dir
}

# ---------- 第 4 步：（可选）引导配置 CZ API Key 接入 Claude Code ----------
function Setup-ApiKey {
    Write-Host ""
    Write-Host "----------------------------------------"
    Write-Host "想让 MCP Server 真正接入 Claude Code 跑起来？"
    Write-Host "Claude Code 需调用 Anthropic API。国内直连 anthropic.com 受限，"
    Write-Host "推荐用云间 API 中转站："
    Write-Host "  · 价格低至官方两折，国内直连无需翻墙"
    Write-Host "  · 支持 90+ 模型（Claude/GPT/DeepSeek），香港节点延迟低"
    Write-Host ""
    Write-Host "是否现在跳转注册并获取 API Key？"
    Write-Host "  Y - 立即跳转至 $CLOUDZONE_URL"
    Write-Host "  N - 我已有 Key，自行输入"
    $choice = Read-Host "请选择 [Y/N]"

    if ($choice -eq "Y" -or $choice -eq "y") {
        Write-Info "正在打开浏览器..."
        try { Start-Process $CLOUDZONE_URL } catch { Write-Warn "无法自动打开浏览器，请手动访问：$CLOUDZONE_URL" }
        Write-Host "注册后在「我的 API Key」页面复制 Key（以 sk- 开头）。"
        $sec = Read-Host "粘贴你的 API Key" -AsSecureString
        # SecureString 转明文用于写入配置文件（仅本会话内）
        $bstr = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($sec)
        $apiKey = [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($bstr)
    } else {
        $sec = Read-Host "请输入你的 API Key (sk-...)" -AsSecureString
        $bstr = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($sec)
        $apiKey = [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($bstr)
    }

    if ([string]::IsNullOrWhiteSpace($apiKey)) {
        Write-Warn "未输入 API Key，跳过 Claude Code 配置。可稍后手动设置。"
        return
    }

    # 写入用户环境变量（永久生效）
    [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $apiKey, "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $CLOUDZONE_API_BASE, "User")
    Write-Info "已写入用户环境变量：ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL"
    Write-Warn "新开 PowerShell/CMD 窗口才会生效。当前窗口请手动 `$env:ANTHROPIC_API_KEY=... `$env:ANTHROPIC_BASE_URL='$CLOUDZONE_API_BASE'"
}

# ---------- 主流程 ----------
Write-Host "============================================"
Write-Host "  MCP Server 开发实战 一键部署"
Write-Host "  Windows PowerShell 版"
Write-Host "============================================"
Write-Host ""

$net = Detect-Network
$pyExe = Check-Python
Install-Uv $net
$dir = Create-Server $net $pyExe

Write-Host ""
Write-Step "启动 MCP Inspector 测试..."
Write-Host "示例 server 在：$dir\server.py"
Write-Host "运行下面命令打开 Inspector（浏览器交互界面）："
Write-Host "  cd $dir; uv run mcp dev server.py"
Write-Host ""
Write-Host "在 Inspector 里调用 add(1, 2) 应得 3，greeting('World') 返回 'Hello, World!'"
Write-Host ""

$wantKey = Read-Host "是否现在配置云间 API Key 接入 Claude Code？[Y/N]"
if ($wantKey -eq "Y" -or $wantKey -eq "y") {
    Setup-ApiKey
}

Write-Host ""
Write-Info "全部完成！详细说明见博客：https://cleanresolver.com/tutorials/mcp-server-develop-guide/"
Write-Host "完整脚本源码已在文末公开，也可从 /scripts/setup-mcp-demo.ps1 下载"