What is MCP¶

模型上下文协议（MCP）简介¶

模型上下文协议（Model Context Protocol，简称MCP）是一种标准化的接口规范，旨在实现人工智能模型与外部工具、资源之间的无缝交互。通过定义统一的数据交换格式和通信机制，MCP能够打破数据孤岛现象，促进不同系统之间的互操作性，从而提升AI应用的灵活性和扩展性。

在MCP出现之前，AI应用与外部工具的交互依赖于手动API连接、插件接口和Agent框架等方法。然而，这些传统方法存在诸多问题： 复杂性高：开发者需要针对每个外部工具单独编写适配代码，增加了开发和维护的难度。 可扩展性差：当外部工具或资源发生变化时，原有的集成方式可能失效，导致系统难以适应动态变化的需求。 缺乏标准化：不同工具和框架之间的接口设计差异较大，缺乏统一的标准，使得跨平台协作变得困难。

MCP通过引入一种通用的协议层，解决了上述问题。它不仅简化了AI模型与外部工具的集成过程，还为未来的扩展提供了良好的基础。

MCP 核心架构¶

客户端-服务器模型¶

flowchart LR
    subgraph "MCP 客户端（Host）"
        A[AI 应用<br/>Cursor/Claude/OpenClaw]
        B[MCP 客户端库]
    end

    subgraph "MCP 服务器（Tools）"
        C1[文件系统服务器]
        C2[数据库服务器]
        C3[API 服务器]
        C4[浏览器服务器]
    end

    A --> B
    B <-->|MCP 协议| C1
    B <-->|MCP 协议| C2
    B <-->|MCP 协议| C3
    B <-->|MCP 协议| C4

    style A fill:#4a90e2,color:#fff
    style B fill:#50c878,color:#fff
    style C1 fill:#f39c12,color:#fff
    style C2 fill:#f39c12,color:#fff
    style C3 fill:#f39c12,color:#fff
    style C4 fill:#f39c12,color:#fff

核心概念：

• MCP Host（客户端）：AI 应用（如 Cursor、Claude Desktop、OpenClaw），负责调用 MCP 服务器
• MCP Server（服务器）：提供工具和数据源的独立进程，通过 MCP 协议暴露能力
• MCP 协议：基于 JSON-RPC 2.0 的通信协议，定义了请求/响应格式

MCP 的核心特性¶

MCP 工作原理¶

通信流程¶

sequenceDiagram
    participant U as 用户
    participant C as MCP 客户端<br/>(Cursor/Claude)
    participant S as MCP 服务器<br/>(工具)

    U->>C: 发送请求
    C->>S: 1. 连接服务器
    S-->>C: 返回可用工具列表
    C->>C: 2. 模型推理<br/>选择工具
    C->>S: 3. 调用工具<br/>(JSON-RPC)
    S->>S: 执行操作
    S-->>C: 4. 返回结果
    C->>C: 5. 模型生成回答
    C-->>U: 返回最终结果

MCP 协议要素¶

MCP 基于 JSON-RPC 2.0，定义了三类核心能力：

快速上手：配置 MCP 服务器¶

在 Cursor 中配置¶

Cursor 通过 .cursor/mcp.json 或 ~/.cursor/mcp.json 配置 MCP 服务器：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_token_here"
      }
    }
  }
}

在 Claude Desktop 中配置¶

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

1
2
3
4
5
6
7
8

{
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": ["mcp-server-sqlite", "--db-path", "/path/to/database.db"]
    }
  }
}

在 OpenClaw 中配置¶

编辑 ~/.openclaw/openclaw.json：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

{
  "tools": {
    "mcp": {
      "enabled": true,
      "servers": {
        "filesystem": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/Documents"]
        }
      }
    }
  }
}

常用 MCP 服务器¶

官方服务器¶

社区服务器¶

• AWS 文档：uvx awslabs.aws-documentation-mcp-server@latest
• Slack：npx -y @modelcontextprotocol/server-slack
• Notion：社区开发的 Notion 集成
• Obsidian：笔记管理集成

完整列表见：MCP Servers Directory

开发自定义 MCP 服务器¶

最小示例（TypeScript）¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  {
    name: "my-custom-server",
    version: "1.0.0",
  },
  {
    capabilities: {
      tools: {},
    },
  }
);

// 注册工具
server.setRequestHandler("tools/list", async () => {
  return {
    tools: [
      {
        name: "get_weather",
        description: "获取指定城市的天气",
        inputSchema: {
          type: "object",
          properties: {
            city: {
              type: "string",
              description: "城市名称",
            },
          },
          required: ["city"],
        },
      },
    ],
  };
});

// 处理工具调用
server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "get_weather") {
    const city = request.params.arguments.city;
    // 实际实现中调用天气 API
    return {
      content: [
        {
          type: "text",
          text: `${city}的天气：晴，25°C`,
        },
      ],
    };
  }
  throw new Error("Unknown tool");
});

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

Python 示例¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

from mcp.server import Server
from mcp.server.stdio import stdio_server

app = Server("my-python-server")

@app.list_tools()
async def list_tools():
    return [
        {
            "name": "calculate",
            "description": "执行数学计算",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "expression": {"type": "string"}
                },
                "required": ["expression"]
            }
        }
    ]

@app.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "calculate":
        result = eval(arguments["expression"])
        return {"result": result}

if __name__ == "__main__":
    stdio_server(app)

MCP 的应用场景¶

1. 开发工具集成¶

• 代码仓库：GitHub、GitLab、Bitbucket 操作
• CI/CD：触发构建、查看日志、部署管理
• 数据库：查询、更新、Schema 管理

2. 企业系统集成¶

• CRM：Salesforce、HubSpot 数据访问
• 项目管理：Jira、Linear、Asana 任务操作
• 通信：Slack、Teams、飞书消息发送

3. 数据分析¶

• 数据库：SQL 查询、数据导出
• 文件系统：CSV、Excel、JSON 文件读写
• API：第三方数据源接入

4. 内容创作¶

• 笔记系统：Obsidian、Notion 集成
• 文档生成：Markdown、PDF 生成
• 媒体处理：图像、音频、视频操作

5. 智能助手¶

• 多模态 AI：整合文本、图像、音频数据源
• 个人助手：日历、邮件、待办事项管理
• 企业助手：内部知识库、工作流自动化

MCP vs 其他方案¶

MCP 生态现状（2026 年）¶

支持 MCP 的平台¶

• IDE：Cursor、Windsurf、Zed、Continue
• AI 应用：Claude Desktop、OpenClaw、Cline
• 框架：LangChain、LlamaIndex、Haystack
• 其他：30+ 平台和工具

社区发展¶

• GitHub Stars：MCP SDK 仓库 15,000+ 星
• 服务器数量：官方 + 社区超过 200 个
• 开发者：活跃贡献者 1,000+
• 企业采用：多家 AI 公司和企业集成

最佳实践¶

1. 安全性¶

• 使用环境变量存储敏感信息（API Key、Token）
• 限制文件系统访问路径
• 为不同服务器设置不同权限
• 定期审计服务器日志

2. 性能优化¶

• 缓存频繁访问的数据
• 使用连接池管理数据库连接
• 异步处理长时间操作
• 限制单次返回数据量

3. 错误处理¶

• 提供清晰的错误消息
• 实现重试机制
• 记录详细日志
• 优雅降级

4. 开发建议¶

• 遵循 MCP 规范
• 提供完整的工具描述和 Schema
• 编写单元测试
• 提供使用文档和示例

故障排查¶

常见问题¶

Q: 服务器无法启动

A: 检查： - 命令路径是否正确 - 依赖是否已安装（npx 需要 Node.js，uvx 需要 uv） - 环境变量是否配置 - 日志中的错误信息

Q: 工具未被发现

A: 确认： - 服务器已在配置文件中注册 - 重启客户端应用 - 检查服务器的 tools/list 响应

Q: 权限错误

A: 检查： - 文件系统路径权限 - API Token 是否有效 - 服务器配置的权限范围

与本站其他文章的关系¶

• AI Agent 入门：MCP 是 Agent 工具层的标准协议
• Skill 使用介绍：Skill 定义流程，MCP 提供工具
• OpenClaw 指南：OpenClaw 通过 MCP 接入工具
• 多智能体协作：多 Agent 可共享 MCP 工具

总结¶

• MCP 是 AI 模型与外部工具之间的标准化协议，由 Anthropic 于 2024 年 11 月推出
• 核心优势：标准化、跨平台、安全隔离、动态发现、双向通信
• 应用场景：开发工具、企业系统、数据分析、内容创作、智能助手
• 生态现状：2026 年已被 30+ 平台采用，200+ 服务器可用
• 开发建议：遵循规范、注重安全、优化性能、完善文档

MCP 正在成为 AI Agent 生态的核心基础设施，统一了工具接入方式，降低了开发成本，促进了生态繁荣。

延伸阅读：MCP 官方文档、MCP SDK、MCP 服务器目录。