基于MCP的AI Agent应用开发实践

最新推荐文章于 2025-05-18 20:17:36 发布

数智前沿

最新推荐文章于 2025-05-18 20:17:36 发布

阅读量1.1k

点赞数 42

分类专栏：数字化转型文章标签：人工智能 MCP agent

本文链接：https://blog.csdn.net/daobaqin/article/details/148047683

版权

数字化转型专栏收录该内容

53 篇文章

订阅专栏

前言：最近大家都在聊 MCP，发现有个最重要的点被忽略了『通过标准化协议，将工具提供方与应用研发者解耦』，这一点带来的将是AI Agent 应用研发范式的转移（类似 Web 应用研发的前后端分离）。

本文以开发 Agent TARS（https://agent-tars.com/）应用为例，尽可能详细地介绍 MCP 在『开发范式』、『工具生态扩展』上起到的作用。

名词解释

Agent：在LLM语境下，AI Agent是某种能自主理解意图、规划决策、执行复杂任务的智能体。Agent并非ChatGPT升级版，它不仅告诉你“如何做”，更会帮你去做。如果CoPilot是副驾驶，那么Agent就是主驾驶。类似人类“做事情”的过程，Agent的核心功能，可以归纳为三个步骤的循环：感知（Perception）、规划（Planning）和行动（Action）。
Copilot：Copilot是指一种基于人工智能的辅助工具，通常与特定的软件或应用程序集成，旨在帮助用户提高工作效率。Copilot 系统通过分析用户的行为、输入、数据和历史记录，提供实时建议、自动化任务或增强功能，帮助用户做出决策或简化操作。
MCP：Model Context Protocol（模型上下文协议）是一个开放协议，它规范了应用程序如何为LLMs提供上下文。可以将MCP想象为AI应用的USB-C端口。就像USB-C提供了一种标准方式，让你的设备连接到各种外设和配件，MCP也提供了一种标准方式，让你的AI模型连接到不同的数据源和工具。
Agent TARS：一个开源的多模态人工智能代理，提供与各种真实世界工具的无缝集成。
RESTful API：RESTful 是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。

背景

AI 从最初只能对话的 Chatbot，辅助人类决策的 Copilot，再到能自主感知和行动的 Agent，AI 在任务中的参与度不断提升。这要求 AI 拥有更丰富的任务上下文（Context），并拥有执行行动所需的工具集（Tools）。

痛点

缺少标准化的上下文和工具集导致开发者的三大痛点：

开发耦合度高：工具开发者需要深入了解 Agent 的内部实现细节，并在 Agent 层编写工具代码。这导致在工具的开发与调试困难。
工具复用性差：因每个工具实现都耦合在 Agent 应用代码内，即使是通过 API 实现适配层在给到 LLM 的出入参上也有区别。从编程语言角度来讲，没办法做到跨编程语言进行复用。
生态碎片化：工具提供方能提供的只有 OpenAPI，由于缺乏标准使得不同 Agent 生态中的工具 Tool 互不兼容。

没有 MCP 时的 Function Call

目标

"All problems in computer science can be solved by another level of indirection" -- Butler Lampson

在计算机科学中，任何问题都可以通过一个抽象层解决。

将工具从 Agent 层解耦出来，单独变成一层 MCP Server 层，并对开发、调用进行标准化。

MCP Server 为上层 Agent 提供上下文（Resources 资源、Prompts）、工具的标准化调用方式。

演示

从几个例子中看 MCP 在 AI Agent 应用中发挥的作用：

1.例子1

指令：

Technical analysis of stock, then buy 3 shares of at market price.

从技术面分析下股票，然后以市价买入 3 股股票
回放：

Replay(https://lf3-static.bytednsdoc.com/obj/eden-cn/100upeupq/report_1742741107345.html)
使用的 MCP Servers:
- LongBridge MCP(https://github.com/longportapp/openapi/tree/main/mcp)：券商服务
- FileSystem(https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem)：文件系统

2.例子2

指令：
- How many CPUs and Memories and Network speed do I have in my machine?
  
  我的机器中的 CPU、内存和网络速度分别是多少？
- Can you write a Python script to execute and obtain the above information?
  
  你能编写一个 Python 脚本来执行并获取上述信息吗？
回放：

Replay(https://lf3-static.bytednsdoc.com/obj/eden-cn/100upeupq/report_1742745014696.html)
使用的 MCP Servers:
- Commands(https://github.com/g0t4/mcp-server-commands)：命令行执行
- code-runner(https://github.com/formulahendry/mcp-server-code-runner)：多种代码语言执行运行器
备注:

第一回合通过命令行获取信息。

第二回合要求用 Python 脚本执行获取。

3.例子3

指令：

Find the top 5 products with the highest number of upvotes on ProductHunt

在 ProductHunt 上找到点赞数最高的前5款产品
回放：

Replay(https://lf3-static.bytednsdoc.com/obj/eden-cn/100upeupq/report_1742745636585.html)
使用的 MCP Servers:
- browser-use(https://github.com/bytedance/UI-TARS-desktop/tree/fb2932afbdd54da757b9fae61e888fc8804e648f/packages/agent-infra/mcp-servers/browser)：本地浏览器访问

4.例子4

指令：

根据这篇文章 https://mp.weixin.qq.com/s/rogMCoS1zDN0mAAC5EKhFQ，调研下各个 Agent 框架的各维度对比，并生成一个报告 markdown
回放：

Replay(https://lf3-static.bytednsdoc.com/obj/eden-cn/100upeupq/report_1744964826641.html)
使用的 MCP Servers：
- Link Reader
备注：

相比 fetch 具备更强的链接抓取能力

已支持自定义 MCP Servers !489!415(https://github.com/bytedance/UI-TARS-desktop/pull/415)，可以添加 Stdio、Streamable HTTP、SSE 类型的 MCP Server。

更多：https://agent-tars.com/showcase

介绍

什么是 MCP？

Model Context Protocol（模型上下文协议）是 Anthropic 在推出的用于 LLM 应用和外部数据源（Resources）或工具（Tools）通信的标准协议，遵循 JSON-RPC 2.0 (https://www.jsonrpc.org/specification)的基础消息格式。

可以把 MCP 想象成 AI 应用程序的 USB-C 接口，规范了应用程序如何为 LLMs 提供上下文。

架构图如下：

MCP Client：通过 MCP 协议与 Servers 通信，并保持 1:1 连接
MCP Servers：上下文提供方，暴露外部数据源（Resources）、工具（Tools）、提示词（Prompts）等由 Client 进行调用。
语言支持层面：TypeScript 和 Python、Java、Kotlin、C#

流程图

一句话解释就是 MCP 提供给 LLM 所需的上下文：Resources 资源、Prompts 提示词、Tools 工具。

MCP 和 Function Call 区别？

	MCP（https://modelcontextprotocol.io/introduction）	Function Call（https://platform.openai.com/docs/guides/function-calling）
定义	模型和其它设备集成的标准接口，包含：工具 Tools：模型可调用的函数方法，与外部系统进行交互，并执行计算资源 Resources：提供给模型的数据、文档、配置、截图等提示词 Prompts：支持用户自定义工具的 Prompt	将模型连接到外部数据和系统，平铺式的罗列 Tools 工具。和 MCP Tool 不同的在于：MCP Tool 的函数约定了输入输出的协议规范。
协议	JSON-RPC，支持双向通信（但目前使用不多）、可发现性、更新通知能力	JSON-Schema，静态函数调用
调用方式	Stdio / SSE / Streamable HTTP / 同进程调用（见下文）	同进程调用 / 编程语言对应的函数
适用场景	更适合动态、复杂的交互场景	单一特定工具、静态函数执行调用
系统集成难度	高	简单
工程化程度	高	低

从前后端分离看 MCP

早期 Web 开发在 JSP、PHP 盛行时，前端交互页面都是耦合在后端逻辑里的，造成开发复杂度高、代码维护困难、前后端协作不便，难以适应现代 Web 应用对用户体验和性能的更高要求。

AJAX、Node.js、RESTful API 推动前后端分离，对应 MCP 也正在实现 AI 开发的“工具分层”：

前后端分离：前端专注界面，后端专注 API 接口。
MCP 分层：让工具开发者和 Agent 开发者各司其职，工具质量和功能的迭代不需要 Agent 开发者感知。这种分层让 AI Agent 开发者能像搭积木一样组合工具，快速构建复杂 AI 应用。

实践

整体设计

以 MCP Browser 浏览器工具（https://github.com/bytedance/UI-TARS-desktop/tree/main/packages/agent-infra/mcp-servers/browser）开发和接入为例，逐步解析具体实现。

在设计 Browser MCP Server 时，并没有采用官方的 stdio call 方式（即通过 npx 方式跨进程调用）。原因是为了降低使用门槛，避免用户在首次使用时先安装 Npm、Node.js 或 UV，从而影响 Agent 开箱即用的体验（相关 issue#64（https://github.com/modelcontextprotocol/servers/issues/64））。

因此，Agent 工具的设计分为两类：

内置 MCP Servers：完全遵循 MCP 规范，同时支持 Stdio 和函数调用。（换句话说用 MCP 标准开发 Function Call）
用户自定义 MCP Servers：针对需要扩展功能的用户，默认他们已经具备 Npm 或 UV 环境，因此可以支持更灵活的扩展方式。

两者的区别：

内置 MCP Servers 是完成当前 Agent 功能的必备工具

调用方式：内置方式不需要 Agent 用户安装 Node.js / npm，这对于普通用户比较友好。

MCP Server 开发

以 mcp-server-browser 为例，其实就是一个 npm 包，package.json 配置如下：

{  "name": "mcp-server-browser",  "version": "0.0.1",  "type": "module",  "bin": {    "mcp-server-browser": "dist/index.cjs"  },  "main": "dist/server.cjs",  "module": "dist/server.js",  "types": "dist/server.d.ts",  "files": [    "dist"  ],  "scripts": {    "build": "rm -rf dist && rslib build && shx chmod +x dist/*.{js,cjs}",    "dev": "npx -y @modelcontextprotocol/inspector tsx src/index.ts"  }}

bin指定通过 stdio 调用的入口文件
main、module 执行通过 Function Call 同进程调用的入口文件

> 开发（dev）

实践下来，通过 Inspector（https://modelcontextprotocol.io/docs/tools/inspector）来开发调试 MCP Server 是比较好，Agent 与工具解耦，可以单独调试和开发工具。

直接运行 npm run dev启动一个 Playground，里面包含 MCP Server 可调试的功能（Prompts、Resources、Tools 等）

$ npx -y @modelcontextprotocol/inspector tsx src/index.tsStarting MCP inspector...New SSE connectionSpawned stdio transportConnected MCP client to backing server transportCreated web app transportCreated web app transportSet up MCP proxy🔍 MCP Inspector is up and running at http://localhost:5173 🚀

注：用 Inspector 调试开发 Server 时，console.log 是无法显示的，这点 debug 确实有点麻烦。

> 实现（Implement）

启动入口（Entry）

为了内置 MCP Server 可以当 Function call 同进程调用，这里在入口文件 src/server.ts 中导出三个共用方法：

listTools：列举所有函数
callTool：调用具体函数
close：Server 不使用后的清理函数

// src/server.tsexport const client: Pick<Client, 'callTool' | 'listTools' | 'close'> = {  callTool,  listTools,  close,};

同时 Stdio 调用支持，直接在 src/index.ts导入模块即可使用。

#!/usr/bin/env node// src/index.tsimport { client as mcpBrowserClient } from "./server.js";const server = new Server(  {    name: "example-servers/puppeteer",    version: "0.1.0",  },  {    capabilities: {      tools: {},    },  });// listToolsserver.setRequestHandler(ListToolsRequestSchema, mcpBrowserClient.listTools);// callToolserver.setRequestHandler(CallToolRequestSchema, async (request) =>  return await mcpBrowserClient.callTool(request.params););async function runServer() {  const transport = new StdioServerTransport();  await server.connect(transport);}runServer().catch(console.error);process.stdin.on("close", () => {  console.error("Browser MCP Server closed");  server.close();});

工具定义（Definition）

MCP 协议要求用 JSON Schema 约束工具的入参、出参，这里实践下来：推荐用 zod(https://github.com/colinhacks/zod) 来定义一套 Zod Schema，导出到 MCP 时再将 zod 转成 JSON Schema。

import { z } from 'zod';const toolsMap = {  browser_navigate: {    description: 'Navigate to a URL',    inputSchema: z.object({      url: z.string(),    }),    handle: async (args) => {      // Implements      const clickableElements = ['...']      return {        content: [          {            type: 'text',            text: `Navigated to ${args.url}\nclickable elements: ${clickableElements}`,          },        ],        isError: false,      }    }  },  browser_scroll: {    name: 'browser_scroll',    description: 'Scroll the page',    inputSchema: z.object({      amount: z        .number()        .describe('Pixels to scroll (positive for down, negative for up)'),    }),    handle: async (args) => {      return {        content: [          {            type: 'text',            text: `Scrolled ${actualScroll} pixels. ${              isAtBottom                ? 'Reached the bottom of the page.'                : 'Did not reach the bottom of the page.'            }`,          },        ],        isError: false,      };    }  },  // more};const callTool = async ({ name, arguments: toolArgs }) => {  return handlers[name].handle(toolArgs);}

技巧 Tips：与 OpenAPI 返回结构化数据不同，MCP 的返回值专为 LLM 模型设计。为了更好地连接模型与工具，返回的文本和工具的描述 description 应更具语义化，从而提升模型的理解能力，提高工具调用的成功率。

例如，browser_scroll（浏览器滚动）在每次执行工具后，应返回页面的滚动状态（如距底部剩余像素、是否已到底等）。这样模型在下次调用工具时即可精准提供合适的参数。

Agent 集成

开发完 MCP Server 后，需要在 Agent 应用中进行集成。原则上，Agent 无需关注 MCP Servers 提供的工具、入参和出参的具体细节。

> MCP Servers 配置

在 MCP Servers 配置中分为『内置 Server』和『用户扩展 Server』，内置 Server 通过同进程 Function Call 调用，保证 Agent 应用对小白用户开箱即用，扩展 Server 则提供给高级用户扩展 Agent 上限功能。

{    // Built-in MCP Servers(in-process call)    fileSystem: {      name: 'fileSystem',      localClient: mcpFsClient,    },    commands: {      name: 'commands',      localClient: mcpCommandClient,    },    browser: {      name: 'browser',      localClient: mcpBrowserClient,    },    // User Custom MCP Servers(stdio/remote call)    fetch: {      command: 'uvx',      args: ['mcp-server-fetch'],    },    longbridge: {      command: 'longport-mcp',      args: [],      env: {}    }}

> MCP Client

MCP Client 的核心任务是集成不同调用方式（Stdio / SSE / Streamable HTTP / Function Call）的 MCP Server。Stdio 和 SSE 方式直接复用了官方示例(https://modelcontextprotocol.io/quickstart/client)，这里主要介绍下我们对 Function Call 调用是怎样在 Client 中支持的。

Function Call 调用

export type MCPServer<ServerNames extends string = string> = {  name: ServerNames;  status: 'activate' | 'error';  description?: string;  env?: Record<string, string>;+ /** in-process call, same as function call */+ localClient?: Pick<Client, 'callTool' | 'listTools' | 'close'>;  /** Stdio server */  command?: string;  args?: string[];};

MCP Client 调用方式如下：

import { MCPClient } from '@agent-infra/mcp-client';import { client as mcpBrowserClient } from '@agent-infra/mcp-server-browser'; const client = new MCPClient([    {      name: 'browser',      description: 'web browser tools',      localClient: mcpBrowserClient,    }]);const mcpTools = await client.listTools();const response = await openai.chat.completions.create({  model,  messages,  // Different model vendors need to convert to the corresponding tools data format.   tools: convertToTools(tools),  tool_choice: 'auto',});

至此，MCP 的整体流程已全部实现，涵盖了从 Server 配置、Client 集成到与 Agent 的衔接等各个环节。更多 MCP 细节/代码已开源到 Github：

Agent 集成：https://github.com/bytedance/UI-TARS-desktop/blob/fb2932afbdd54da757b9fae61e888fc8804e648f/apps/agent-tars/src/main/llmProvider/index.ts#L89-L91

mcp-client：https://github.com/bytedance/UI-TARS-desktop/tree/main/packages/agent-infra/mcp-client

mcp-servers：https://github.com/bytedance/UI-TARS-desktop/tree/main/packages/agent-infra/mcp-servers

> Remote 远程调用

如果是 Web 应用（无法使用 Stdio MCP Server），可以用 FaaS 将 Stdio 转成 SSE MCP Server，从而在 Function Call 的基础上无缝支持 MCP 类型的 Tools，这个过程换句话讲是『MCP Servers 云化』。

调用代码示例：

import asyncioimport openaiimport jsonfrom agents.mcp import MCPUtilfrom agents.mcp import MCPServerSsefrom agents import set_tracing_disabledset_tracing_disabled(True)async def chat():    client = openai.AzureOpenAI(        azure_endpoint=base_url,        api_version=api_version,        api_key=ak,    )+   async with MCPServerSse(+       name="fetch", params={"url": "https://{mcp_faas_id}.mcp.bytedance.net/sse"}+   ) as mcp_server:+       tools = await MCPUtil.get_function_tools(+           mcp_server, convert_schemas_to_strict=False+       )        prompt = "请求下 https://agent-tars.com/，主要是做什么的？"        completion = client.chat.completions.create(            model=model_name,            messages=[{"role": "user", "content": prompt}],            max_tokens=max_tokens,+           tools=[+               {+                   "type": "function",+                   "function": {+                       "name": tool.name,+                       "description": tool.description,+                       "parameters": tool.params_json_schema,+                   },+               }+               for tool in tools+           ],        )        for choice in completion.choices:            if isinstance(choice.message.tool_calls, list):                for tool_call in choice.message.tool_calls:                    if tool_call.function:+                       tool_result = await mcp_server.call_tool(+                           tool_name=tool_call.function.name,+                           arguments=json.loads(+                               tool_call.function.arguments+                           ), # or jsonrepair+                       )+                       print("tool_result", tool_result.content)if __name__ == '__main__':    asyncio.run(chat())

思考

生态

MCP 生态不断发展壮大，越来越多的应用支持 MCP，同时开放平台也提供 MCP Server。像 Cloudflare(https://blog.cloudflare.com/remote-model-context-protocol-servers-mcp/)、Composio(https://mcp.composio.dev/)、Zapier(https://zapier.com/mcp) 使用 SSE / Streamable HTTP 方式将 MCP 进行托管（即接入一个 MCP HTTP Endpoint 即接入 MCP Server）。而通过 Stdio 方式最理想场景是 MCP Servers 和 Agent 系统跑在同一 Docker 容器中（类似 Sidecar 模式）。

MCP 生态图

举个例子：接入地图厂商的 MCP Server 后，Agent 具备生活服务工具能力，远远优于单纯依赖搜索的方式。

未来

目前的 MCP 开发非常初级，在工程化上缺少一套完善的框架来约束和规范。
根据 MCP Roadmap(https://modelcontextprotocol.io/development/roadmap)，未来主要三件事：
- Remote MCP Support：鉴权、服务发现、无状态服务，很明显奔着 K8S 架构去的，这样才能构建一个生产级、可扩展的 MCP 服务。最近提出的 [RFC] Replace HTTP+SSE with new "Streamable HTTP" transport(https://github.com/modelcontextprotocol/modelcontextprotocol/pull/206)，支持 Streamable HTTP，可以无状态、低延迟、双向传输。
- Agent Support：提升不同领域复杂的 Agent 工作流，并可以处理更好的人机交互。
- Developer Ecosystem：更多的开发者和大厂商参与进来，才能扩展 AI Agent 的能力边界。
实践下来，MCP Server SSE 并不是理想的方案，因为需要保持连接和 session 状态，而云服务（如 Serverless）更倾向于无状态架构（issue#273(https://github.com/modelcontextprotocol/typescript-sdk/issues/273#issuecomment-2789489317)），所以最近提出了更适配云场景的 Streamable HTTP Transport。
MCP 模型调用与 RL 强化学习：如果 MCP 成为未来的规范，那么 Agent 应用能否准确调用各个 MCP，将成为模型 RL 未来需要支持的关键功能。与 Function Call 模型不同，MCP 是一个动态的工具库，模型需要具备对新增 MCP 的泛化理解能力。
Agent K8S：虽然目前 LLM 和上下文之间建立了标准化的通信协议，但 Agent 之间的交互协议尚未形成统一标准，Agent 服务发现、恢复、监控、安全等一系列生产级问题待解决。目前 Google 的 A2A(https://developers.googleblog.com/zh-hans/a2a-a-new-era-of-agent-interoperability/)（Agent2Agent）和社区的 ANP(https://agent-network-protocol.com/)（Agent Network Protocol）在做这方面的探索与尝试。

参考

详解 MCP：Agentic AI 中间层最优解，AI 应用的标准化革命(https://mp.weixin.qq.com/s/Ph9qRA2RI7EcRHg_wYIzXQ?poc_token=HDHfCWijwO4rRDuRm27MHkcjkCAt8UEi2ypH3vS_)
a16z详解MCP，以及AI工具的未来(https://mp.weixin.qq.com/s/3d7uf0aEpkkZVgdHk0ri7A)
How to Build an MCP Server Fast: A Step-by-Step Tutorial(https://medium.com/@eugenesh4work/how-to-build-an-mcp-server-fast-a-step-by-step-tutorial-e09faa5f7e3b)
智能体互联网的三大趋势：连接范式正在彻底重构(https://zhuanlan.zhihu.com/p/31870979392)
有了MCP，AI才完整(https://www.youtube.com/watch?v=ElX5HO0wXyo)
硅谷 101：AI Agent爆发前的黎明：Manus不够好，但天快亮了(https://www.youtube.com/watch?v=2PSCnOFkR3U)
MCP 终极指南(https://guangzhengli.com/blog/zh/model-context-protocol)
OpenAI 支持 MCP！(https://x.com/sama/status/1904957253456941061)