MCP

+-------------------------------------------------------------+
|                        MCP Host                             |
|  (Claude Desktop / Claude Code / Cursor / Windsurf ...)     |
|                                                             |
|  +----------------+    +----------------+                   |
|  |  MCP Client 1  |    |  MCP Client 2  |  ...             |
|  |  (连接 Server A)|    |  (连接 Server B)|                  |
|  +-------+--------+    +-------+--------+                   |
+----------|-------------------|------------------------------+
           |                   |
           v                   v
    +-------------+      +-------------+
    | MCP Server A|      | MCP Server B|
    | (GitHub API)|      | (PostgreSQL)|
    +-------------+      +-------------+

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {
      "roots": { "listChanged": true },
      "sampling": {}
    },
    "clientInfo": {
      "name": "ClaudeCode",
      "version": "2.1.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-03-26",
    "capabilities": {
      "logging": {},
      "prompts": { "listChanged": true },
      "resources": { "subscribe": true, "listChanged": true },
      "tools": { "listChanged": true }
    },
    "serverInfo": {
      "name": "github-server",
      "version": "1.0.0"
    },
    "instructions": "Optional instructions for the client"
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

# 基本语法
claude mcp add --transport http <name> <url>

# 连接 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 带 Bearer Token 的认证
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# 基本语法
claude mcp add --transport sse <name> <url>

# 连接 Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

# 基本语法
claude mcp add [options] <name> -- <command> [args...]

# 连接 Airtable
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

# 连接 PostgreSQL 数据库
claude mcp add --transport stdio db -- npx -y @modelcontextprotocol/server-postgres \
  "postgresql://user:pass@localhost:5432/mydb"

# 连接文件系统（限制访问目录）
claude mcp add --transport stdio fs -- npx -y @modelcontextprotocol/server-filesystem \
  /Users/lionad/projects /Users/lionad/documents

# Local 作用域（默认）
claude mcp add --transport http stripe https://mcp.stripe.com

# Project 作用域（团队共享）
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

# User 作用域（跨项目）
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

# 列出所有配置的 Server
claude mcp list

# 查看特定 Server 详情
claude mcp get github

# 移除 Server
claude mcp remove github

# 重置项目作用域的批准选择
claude mcp reset-project-choices

# 在 Claude Code 内检查 Server 状态
/mcp

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

# 使用 GitHub Personal Access Token
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Review PR #456 and suggest improvements
Create a new issue for the bug we just found
Show me all open PRs assigned to me

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

What's our total revenue this month?
Show me the schema for the orders table
Find customers who haven't made a purchase in 90 days

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

What are the most common errors in the last 24 hours?
Show me the stack trace for error ID abc123
Which deployment introduced these new errors?

export MAX_MCP_OUTPUT_TOKENS=50000
claude

# 创建项目目录
mkdir mcp-weather-server && cd mcp-weather-server

# 初始化（使用 Bun 或 npm）
bun init -y
# 或 npm init -y

# 安装 MCP TypeScript SDK 和 Zod
bun add @modelcontextprotocol/sdk zod
# 或 npm install @modelcontextprotocol/sdk zod

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "esModuleInterop": true,
    "strict": true
  }
}

// src/index.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

// 创建服务器实例
const server = new McpServer({
  name: "weather-service",
  version: "1.0.0",
});

// 注册工具（Tools）
server.tool(
  "get_weather",
  "获取指定城市的当前天气信息",
  {
    city: z.string().describe("城市名称，如：北京、上海"),
  },
  async ({ city }) => {
    // 工具实现见下文
    return { content: [{ type: "text", text: `查询 ${city} 的天气...` }] };
  }
);

// 启动服务器
const transport = new StdioServerTransport();
await server.connect(transport);

console.error("MCP Weather Server 已启动，等待连接...");

// 天气查询工具实现
server.tool(
  "get_weather",
  "获取指定城市的当前天气信息",
  {
    city: z.string().describe("城市名称，如：北京、上海"),
  },
  async ({ city }) => {
    const API_KEY = process.env.OPENWEATHER_API_KEY;
    const url = `https://api.openweathermap.org/data/2.5/weather?q=${encodeURIComponent(city)}&appid=${API_KEY}&units=metric&lang=zh_cn`;

    try {
      const response = await fetch(url);
      if (!response.ok) {
        throw new Error(`API 请求失败：${response.status}`);
      }

      const data = await response.json();

      return {
        content: [
          {
            type: "text",
            text: JSON.stringify({
              city: data.name,
              temperature: `${data.main.temp}°C`,
              feels_like: `${data.main.feels_like}°C`,
              description: data.weather[0].description,
              humidity: `${data.main.humidity}%`,
              wind_speed: `${data.wind.speed} m/s`,
            }, null, 2),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `查询失败：${error instanceof Error ? error.message : '未知错误'}`,
          },
        ],
        isError: true,
      };
    }
  }
);

// 提供服务器状态信息
server.resource(
  "server-status",
  "status://server",
  async (uri) => ({
    contents: [
      {
        uri: uri.href,
        text: JSON.stringify({
          name: "Weather Service",
          version: "1.0.0",
          status: "running",
          timestamp: new Date().toISOString(),
        }, null, 2),
      },
    ],
  })
);

// 提供 API 文档
server.resource(
  "api-docs",
  "docs://api",
  async (uri) => ({
    contents: [
      {
        uri: uri.href,
        text: `
# Weather MCP Server API

## Tools
- get_weather(city: string): 获取指定城市天气

## Resources
- status://server - 服务器状态
- docs://api - API 文档
        `.trim(),
      },
    ],
  })
);

// 预定义的天气报告模板
server.prompt(
  "weather_report",
  "生成一份格式化的天气报告",
  {
    city: z.string().describe("城市名称"),
    include_tips: z.boolean().optional().describe("是否包含穿衣建议"),
  },
  ({ city, include_tips }) => ({
    messages: [
      {
        role: "user",
        content: {
          type: "text",
          text: `请为${city}生成一份天气报告。${include_tips ? "同时提供穿衣建议。" : ""}`,
        },
      },
    ],
  })
);

// src/index.ts（完整版）
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({
  name: "weather-service",
  version: "1.0.0",
});

// ===== Tools =====
server.tool("get_weather", /* ... */);

// ===== Resources =====
server.resource("server-status", /* ... */);
server.resource("api-docs", /* ... */);

// ===== Prompts =====
server.prompt("weather_report", /* ... */);

// ===== 错误处理 =====
process.stdin.on("error", (err) => {
  console.error("标准输入错误:", err);
  process.exit(1);
});

process.stdout.on("error", (err) => {
  console.error("标准输出错误:", err);
  process.exit(1);
});

// 优雅退出
process.on("SIGINT", async () => {
  await server.close();
  process.exit(0);
});

// 启动
const transport = new StdioServerTransport();
await server.connect(transport);
console.error("MCP Weather Server 已启动，等待连接...");

# 使用绝对路径配置
claude mcp add --transport stdio weather -- bun run /absolute/path/to/mcp-weather-server/src/index.ts

{
  "mcpServers": {
    "weather": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/mcp-weather-server/src/index.ts"],
      "env": {
        "OPENWEATHER_API_KEY": "your-api-key"
      }
    }
  }
}

// 认证检查
const apiKey = request.headers.get("Authorization");
if (apiKey !== `Bearer ${process.env.API_KEY}`) {
  return new Response("Unauthorized", { status: 401 });
}

// 日志记录
import pino from "pino";
const logger = pino();

server.tool("get_weather", /* ... */, async ({ city }) => {
  logger.info({ city }, "查询天气");
  // ...
});

用户请求 → 大模型生成 Function Call → 转换为 MCP 请求 → 调用工具 → 结果返回模型

claude mcp add --transport stdio postgres -- npx -y \
  @modelcontextprotocol/server-postgres \
  "postgresql://readonly:pass@localhost:5432/analytics"

> 本月总收入是多少？
[Claude 自动调用 MCP 工具查询数据库]

> 显示 orders 表的 Schema
[Claude 自动调用 schema 查询工具]

> 找出 90 天内未购买的客户
[Claude 生成并执行 SQL 查询]

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

> Review PR #456 并给出改进建议
[Claude 读取 PR  diff、评论、CI 状态，生成审查报告]

> 为刚发现的 bug 创建一个新 Issue
[Claude 自动创建 Issue，包含复现步骤和堆栈跟踪]

> 显示分配给我的所有开放 PR
[Claude 查询并列出 PR 列表]

> 实现 JIRA 工单 ENG-4521 描述的功能并在 GitHub 创建 PR
[Claude 读取工单 → 编写代码 → 提交 → 创建 PR]

claude mcp add --transport http slack https://mcp.slack.com/mcp

> 总结 #engineering 频道今天的讨论
[Claude 读取频道消息并生成摘要]

> 根据 Slack 中发布的新 Figma 设计更新邮件模板
[Claude 读取 Slack 中的设计链接 → 获取 Figma 内容 → 更新代码]

> 给参与讨论的 10 位用户发送反馈会议邀请
[Claude 提取用户列表 → 生成邮件草稿]

用户: "实现 JIRA 工单 ENG-4521 的功能，基于我们的设计规范，
       然后创建 PR 并通知团队"

Claude 的执行流程：
1. [JIRA MCP] 读取 ENG-4521 的详细描述
2. [Figma MCP] 获取相关设计稿
3. [Git MCP] 检查当前分支状态
4. [Filesystem MCP] 读取项目代码规范
5. 编写代码实现功能
6. [Git MCP] 提交代码
7. [GitHub MCP] 创建 PR
8. [Slack MCP] 在 #engineering 频道通知团队

// /Library/Application Support/ClaudeCode/managed-mcp.json (macOS)
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    }
  },
  "deniedMcpServers": [
    { "serverUrl": "https://*.untrusted.com/*" },
    { "serverCommand": ["npx", "-y", "unapproved-package"] }
  ]
}