MCP 协议入门,让你的 Agent 连接微信、文档和数据库

8 阅读8分钟

MCP 协议入门,让你的 Agent 连接微信、文档和数据库

实战:手把手做一个 Mini Code Agent · 第 6 篇

上一篇我们解决了 Skill 数量增长后的 Token 爆炸问题,Agent 现在能高效管理 20 个以上的 Skill 了。但你很快会发现一个新问题:Agent 虽然能读文件、能跑命令,但它进不了你的微信、看不到你的飞书文档、查不了你的数据库。它被锁在本地文件系统里。这一篇,我们学习 MCP 协议,让 Agent 连接外部世界。

先看一个让你眼馋的场景。

同事的 Agent 能直接在企微群里回复消息,能自动读取飞书文档生成周报,能查询数据库里的客户信息然后生成分析报告。你的 Agent 只能读本地文件、跑本地命令。你想让它也连上微信,它说做不到。你想让它查一下数据库,它说没有工具。

你的 Agent 有手有脚,但被困在本地。

问题不在 Agent 的能力,而在它缺少连接外部世界的标准协议。每个平台都有自己的 API,每个 API 都有不同的认证方式、数据格式、调用规则。你不可能为每个平台写一个适配器。

今天这篇,我们学习 MCP 协议。MCP 是 Model Context Protocol 的缩写,是 Anthropic 提出的开放协议,2026 年已成为 Agent 工具生态的事实标准。它让 Agent 用统一的方式连接任何外部系统。


一、问题:为什么你的 Agent 进不了外部世界

把场景拆开看,Agent 被困在本地的根源只有一个:缺少标准协议。

你想让 Agent 读微信消息,微信有 API,但认证方式是 OAuth,数据格式是 Protobuf。你想让 Agent 查数据库,数据库有连接库,但每个数据库的查询语言都不一样。你想让 Agent 读飞书文档,飞书有开放平台,但接口规则和其他平台完全不同。

结果就是:每接一个新平台,你都要写一套适配代码。3 个平台还能忍,10 个平台就崩溃了。

这不是 Mini Agent 独有的问题。所有 coding agent 都面临同样的挑战。看看社区里的成熟方案是怎么解决的:Claude Code 原生支持 MCP,可以连接任何 MCP 服务器。OpenClaw 用 MCP 连接微信、飞书、钉钉等消息平台。OpenCode 支持 MCP 工具,可以扩展任何外部能力。

它们形态不同,但都在做同一件事:用 MCP 协议作为 Agent 和外部世界之间的通用语言。

结论先行:MCP 就是 Agent 的 USB 接口。就像 USB 让任何设备连接任何电脑,MCP 让任何 Agent 连接任何外部系统。你不需要为每个平台写适配器,只需要找到对应的 MCP 服务器,即插即用。


二、分析:MCP 为什么能成为 Agent 的 USB 接口

先看 MCP 的核心架构。MCP 采用客户端-服务器模型:

Text

┌─────────────────────────────────────────┐
│           MCP Host(Agent)              │
│  ┌─────────────────────────────────┐    │
│  │         MCP Client              │    │
│  │  负责和 MCP Server 通信          │    │
│  └─────────────┬───────────────────┘    │
└────────────────┼────────────────────────┘
                 │ MCP 协议
┌────────────────┼────────────────────────┐
│           MCP Server                    │
│  ┌─────────────────────────────────┐    │
│  │  Tools: 外部系统提供的工具        │    │
│  │  Resources: 外部系统提供的资源    │    │
│  │  Prompts: 外部系统提供的提示词    │    │
│  └─────────────────────────────────┘    │
└─────────────────────────────────────────┘

MCP Server 是外部系统的适配器,它把外部系统的 API 包装成 MCP 协议的标准格式。MCP Client 是 Agent 侧的连接器,它用统一的方式调用任何 MCP Server。

关键设计:MCP 协议定义了三种能力。

Tools:外部系统提供的工具。 比如微信 MCP Server 提供 send_message 工具,数据库 MCP Server 提供 query 工具。Agent 调用这些工具,就像调用本地函数一样。

Resources:外部系统提供的资源。 比如飞书文档 MCP Server 提供文档列表资源,GitHub MCP Server 提供仓库列表资源。Agent 读取这些资源,就像读取本地文件一样。

Prompts:外部系统提供的提示词。 比如一个代码审查 MCP Server 提供 review_prompt 提示词,Agent 加载这个提示词,就像加载本地 Skill 一样。

现在把 MCP 接入 Mini Agent。只需要加一个 MCP Client:

Python

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

class MCPClient:
    def __init__(self):
        self.session = None
        self.tools = []

    async def connect(self, server_script: str):
        """连接 MCP Server"""
        server_params = StdioServerParameters(
            command="python",
            args=[server_script],
            env=None
        )
        self._stdio = stdio_client(server_params)
        self._session = await self._stdio.__aenter__()
        await self._session.initialize()

        # 获取可用工具列表
        tools_result = await self._session.list_tools()
        self.tools = tools_result.tools
        print(f"🔌 已连接 MCP Server,可用工具:{[t.name for t in self.tools]}")

    async def call_tool(self, tool_name: str, arguments: dict) -> str:
        """调用 MCP 工具"""
        result = await self._session.call_tool(tool_name, arguments)
        return result.content[0].text

    async def disconnect(self):
        """断开连接"""
        await self._stdio.__aexit__(None, None, None)

就这几行。Agent 现在可以连接任何 MCP Server,调用任何外部工具。

你可能会问,为什么不用更简单的方案?比如直接调用外部 API?

因为直接调用 API 意味着你要处理每个平台的认证、错误处理、数据格式转换。MCP 把这些都抽象掉了,你只需要关心调用什么工具、传什么参数。

那为什么不用更复杂的方案?比如自己写一个协议?

因为 MCP 已经是事实标准。Claude Code、OpenCode、OpenClaw 都支持 MCP。社区已经有上千个 MCP Server,覆盖微信、飞书、钉钉、数据库、浏览器、GitHub 等几乎所有常用平台。你自己写协议,就是和社区生态脱节。

用 MCP,就是站在生态的肩膀上。


三、解决:30 分钟让 Agent 连接外部世界

3.1 环境准备

bash

pip install mcp

3.2 找一个 MCP Server

社区有很多现成的 MCP Server。比如:

MCP Server功能安装方式
wechat-mcp微信消息收发pip install wechat-mcp
feishu-mcp飞书文档读写pip install feishu-mcp
sqlite-mcpSQLite 数据库查询pip install sqlite-mcp
github-mcpGitHub 仓库操作pip install github-mcp

我们以 sqlite-mcp 为例,让 Agent 能查询数据库。

3.3 接入 Mini Agent

Python

# 在 cli.py 里加入 MCP 支持
from .mcp_client import MCPClient

async def main():
    # ... 原有代码 ...

    # 连接 MCP Server
    mcp = MCPClient()
    await mcp.connect("sqlite_mcp_server.py")  # MCP Server 脚本路径

    # 把 MCP 工具注册到 Agent
    for tool in mcp.tools:
        TOOLS[tool.name] = lambda **kwargs: mcp.call_tool(tool.name, kwargs)
        TOOL_SCHEMAS.append({
            "type": "function",
            "function": {
                "name": tool.name,
                "description": tool.description,
                "parameters": tool.inputSchema,
            }
        })

    # ... 执行任务 ...

    await mcp.disconnect()

3.4 实战:让 Agent 查询数据库

bash

$ mini-agent "查一下用户表里最近 7 天注册的人数"

🔌 已连接 MCP Server,可用工具:['query', 'list_tables']

🔧 调用 list_tables({})
📋 结果: users, orders, products

🔧 调用 query({'sql': 'SELECT COUNT(*) FROM users WHERE created_at > datetime("now", "-7 days")'})
📋 结果: 42

🤖 最近 7 天有 42 个新用户注册。

Agent 现在能查数据库了。你不需要写 SQL 解析器,不需要处理数据库连接,MCP Server 帮你做了所有事。

3.5 实战:让 Agent 发送微信消息

bash

$ mini-agent "给张三发一条消息,说会议改到下午 3 点"

🔌 已连接 MCP Server,可用工具:['send_message', 'get_contacts']

🔧 调用 get_contacts({})
📋 结果: [{"name": "张三", "id": "zhangsan"}, ...]

🔧 调用 send_message({'to': 'zhangsan', 'content': '会议改到下午 3 点'})
📋 结果: 发送成功

🤖 已发送给张三:会议改到下午 3 点

Agent 现在能发微信了。你不需要处理微信 OAuth,不需要处理 Protobuf 编码,MCP Server 帮你做了所有事。

3.6 Before vs After 对比

Before:没有 MCP 时

bash

$ mini-agent "查一下用户表里最近 7 天注册的人数"

🤖 我无法访问数据库。你可以手动执行以下 SQL:
SELECT COUNT(*) FROM users WHERE created_at > datetime('now', '-7 days')
然后把结果告诉我。

After:有 MCP 时

bash

$ mini-agent "查一下用户表里最近 7 天注册的人数"

🔌 已连接 MCP Server,可用工具:['query', 'list_tables']

🔧 调用 list_tables({})
📋 结果: users, orders, products

🔧 调用 query({'sql': 'SELECT COUNT(*) FROM users WHERE created_at > datetime("now", "-7 days")'})
📋 结果: 42

🤖 最近 7 天有 42 个新用户注册。

差距一目了然。前者是旁观者,后者是参与者。


四、延伸:从 MCP 到多 Agent 协作

MCP 解决了 Agent 连接外部世界的问题。但当你的 Agent 需要处理复杂任务时,一个 Agent 可能搞不定。比如,你需要一个 Agent 查数据库,一个 Agent 写报告,一个 Agent 发邮件。这时候就需要多 Agent 协作。

新需求解决方案参考项目
多个 Agent 分工协作多 Agent 编排,Handoff 机制OpenClaw 的多 Agent 调度
Agent 之间需要通信消息队列,事件驱动OpenHands 的消息总线
Agent 需要长期运行守护进程,定时任务OpenClaw 的 7x24 运行机制
Agent 需要人类监督Human-in-the-loop,审批机制ecc 的 hooks 系统

但别急着全都做。 先让 Agent 连上一个 MCP Server,解决一个真实问题。等单 Agent 搞不定了,再考虑多 Agent。


速记表

概念一句话
MCPAgent 的 USB 接口,统一协议连接任何外部系统
三种能力Tools 是工具,Resources 是资源,Prompts 是提示词
接入方式安装 MCP Server,用 MCP Client 连接,注册工具到 Agent
社区生态上千个 MCP Server,覆盖微信、飞书、数据库、GitHub 等
下一步连上一个 MCP Server,解决一个真实问题

Q&A

Q1:MCP 和直接调用 API 有什么区别?

MCP 抽象掉了认证、错误处理、数据格式转换等细节。你只需要关心调用什么工具、传什么参数。直接调用 API 意味着你要处理所有这些细节。

Q2:如何找到合适的 MCP Server?

去 MCP 社区市场搜索,比如 punkpeye/awesome-mcp-servers 这个仓库收录了上千个 MCP Server。也可以自己写,MCP SDK 提供了 Python 和 TypeScript 两种实现。

Q3:MCP Server 安全吗?

MCP Server 有权限控制机制,可以限制 Agent 能调用什么工具、访问什么资源。但和任何外部系统一样,需要谨慎对待敏感操作,比如发送消息、修改数据。

Q4:下一步学什么?

下一篇我们学习多 Agent 协作,让多个 Agent 分工合作,处理复杂任务。


📦 MCP Client 代码和常用 MCP Server 推荐清单 → 评论区扣「MCP」或私信获取


系列回顾:

  • 第 1 篇:你的 AI 只会聊天?30 行代码让它读懂你的项目
  • 第 2 篇:一份 AGENTS.md,让你的 Mini Agent 记住项目规范
  • 第 3 篇:从脚本到 CLI,把你的 Agent 变成团队都能用的工具
  • 第 4 篇:给 Agent 装上 Skill,让它按你的流程干活
  • 第 5 篇:你的 Skill 越多越蠢?Token 上下文爆炸的求生指南
  • 第 6 篇(本篇):MCP 协议入门,让你的 Agent 连接微信、文档和数据库
  • 第 7 篇:多 Agent 协作,从单兵作战到团队流水线

觉得有用?点赞 👍 加收藏 ⭐,下一篇我们让多个 Agent 分工合作。