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

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

arduino 复制代码
┌─────────────────────────────────────────┐
│           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

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-mcp SQLite 数据库查询 pip install sqlite-mcp
github-mcp GitHub 仓库操作 pip install github-mcp

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

3.3 接入 Mini Agent

Python

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

css 复制代码
$ 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

css 复制代码
$ 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

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

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

After:有 MCP 时

bash

css 复制代码
$ 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。


速记表

概念 一句话
MCP Agent 的 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 分工合作。

相关推荐
Danny转行做跨境13 小时前
跨境数据CLI怎么用? 一个命令行调61个接口实录
跨境电商·mcp·sorftime
Flynt15 小时前
我让 AI 给掘金首页做了次性能体检:LCP 8.9 秒是真的,但它判读错了一处
chrome·性能优化·mcp
prince_zxill1 天前
把 17 个散文件装进一个文件夹:拆解 claude-plugins-official 的插件打包术(47,413 Star 实测)
python·github·agent·mcp·claude code
xrlfreedom1 天前
MCP 面试高频考点:给 MCP Server 加日志、指标与分布式追踪,面试追问你能答到第几层?
结构化输出·mcp·mcp server
leer2 天前
我给 agent 加了一道闸,拦住了自己差点删掉的构建目录
mcp
莪_幻尘2 天前
AI 编程的下一场战争,不在模型,在协议
agent·ai编程·mcp
我不会起名字3223 天前
Agent 总调错工具?MCP 接进 Go 后端的 4 个约束
后端·go·agent·mcp
vivo互联网技术3 天前
研发数字人 Agent:从 0 到 1 的架构与实践
人工智能·agent·mcp