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 分工合作。