这两年 AI 开发圈讨论最多的方向里MCP 绝对排得上号。而落到内容系统、付费内容平台、多商户 SaaS 这类实际业务时很多同学会遇到同一个问题模型能力很强但怎么才能让 AI 安全、可控地调用“我自己的业务数据”和“我自己的业务工具”本文围绕 MCP 内容系统开发这条主线从一个内容付费 多商户的真实业务场景出发带大家从概念到代码完整实现一个 MCP Content Server并讲解工具设计、数据隔离、调试方法和工程落地思路。无论你是做软件开发、网站开发还是正在设计内容付费系统这篇文章都值得收藏。1. 背景与核心概念1.1 什么是 MCP 协议MCP 全称 Model Context Protocol即模型上下文协议。它最早由 Anthropic 提出并开源目标是解决一个很现实的问题大语言模型本身无法直接访问外部数据和服务早期的做法是每个应用自己写一套 Prompt 私有 API 调用导致“模型和应用之间”没有统一标准重复开发严重扩展性也不好。MCP 相当于在 AI 模型与外部工具、数据源、业务系统之间定义了一套标准化的“插头接口”。有了 MCP大模型不再需要知道每个业务系统内部怎么实现只需要通过 MCP 客户端去发现工具、调用工具、获取资源。打个比方MCP 就像 USB-C 接口之前每个设备都有自己的充电线而现在大家统一用同一个标准协议接入成本和维护成本都大幅下降。在软件开发领域MCP 已经被越来越多地用于 AI 编程助手、低代码平台、自动化运维工具中。比如 Claude Desktop、Codex 这类 AI 客户端都支持通过 MCP 扩展工具集让模型能操作文件、查数据库、调接口。也有像蓝湖 MCP、Figma MCP 这样的设计协作工具通过 MCP 把设计稿信息直接暴露给 AI辅助生成前端代码。1.2 什么是 MCP 内容系统所谓 MCP 内容系统并不是某个独立软件产品而是指把内容系统的核心业务能力文章管理、内容发布、付费配置、订单查询、数据统计等通过 MCP 协议封装成标准工具集让 AI Agent 可以像调用“手机 App 功能”一样安全地操作内容后台。举一个具体场景一个内容付费平台后台有文章表、支付订单表、商户表。传统网站开发中运营人员需要登录管理后台手动创建文章、点击发布、配置价格、查看订单。而接入 MCP 之后运营人员可以在 AI 对话界面中说一句“帮我把 m001 商户下的那篇《MCP 入门》文章设为付费价格 9.9 元”AI 客户端就会自动调用 MCP 工具完成配置并返回结果。这里的核心变化是AI 从“只会聊天”变成了“能干活”。而 MCP 内容系统的目标就是把内容后台改造成 AI 可操作的业务系统。对于多商户系统来说这种能力更有价值因为商户数量多了之后人工运营效率会成为瓶颈AI 辅助运营能显著降低操作成本。1.3 为什么内容系统需要接入 MCP内容系统接入 MCP最大的收益是解决了“模型能力与业务数据打通”的问题。首先传统内容系统开发过程中业务逻辑通常是封装成 HTTP API 给前端管理后台调用。前端页面是人点的但 AI 不能直接“点页面”。如果希望 AI 帮助运营人员处理内容审核、文章发布、价格调整等操作就需要一种让 AI 能调用后端能力的方式。MCP 提供了这种标准化方式并且比让模型直接拼接 HTTP 请求更安全、更可控。其次MCP 的 Tool 机制带有参数描述模型可以根据自然语言自动决定调用哪个工具、传入什么参数。这意味着网站开发中原本需要开发大量定制化 Prompt 的环节可以收敛为“定义好 MCP 工具集 提供清晰的参数说明”模型会自动学会使用。最后MCP 对多商户系统非常友好。多商户系统最敏感的就是数据隔离MCP 工具可以在服务端校验商户身份、检查资源归属再做数据返回。这比把数据库连接暴露给模型或者让模型直接生成 SQL 要安全得多。1.4 MCP 与 Agent Skill、RAG 的关系最近很多人在讨论“Agent Skill 和 MCP 有什么区别”这里简单梳理一下。Agent Skill 更偏上层是 Agent 对某类能力的封装。比如“数据分析技能”“内容写作技能”它描述的是 Agent 能完成什么样的任务内部可以包含提示词、代码、工具调用策略。而 MCP 是底层的通信协议它解决的是“模型与外部工具之间怎么连接、怎么调用、怎么传数据”的问题。可以这样理解Skill 是招式MCP 是传输数据的协议。RAG检索增强生成和 MCP 也不是竞争关系而是互补关系。RAG 解决模型知识实时性不足的问题需要检索系统从知识库中找出相关内容再交给模型这个检索能力本身完全可以封装成 MCP 工具。比如在内容系统中可以把“按关键词搜索文章”封装为 MCP Tool模型需要时直接调用获得最新数据再基于这些生成回答。明白了这些关系再去看 MCP 内容系统开发就会更清晰我们要做的是把内容业务封装成 MCP 工具让 AI 客户端通过协议连接并调用。2. 环境准备与版本说明2.1 基础环境本文示例基于 Node.js 开发因为 MCP 官方 TypeScript/JavaScript SDK 使用最广生态也比较成熟。操作系统macOS / Linux / Windows 均可。Node.js建议 18 及以上版本更高版本更好。包管理器npm 或 pnpm 均可本文使用 npm。IDEVS Code 或其他支持 JavaScript 的编辑器。需要说明的是MCP SDK 目前仍处于快速迭代阶段不同版本的 API 会有差异。本文示例以常见写法演示你安装依赖后如果发现某个 API 已调整建议以当前安装版本对应的官方文档为准。2.2 项目结构规划我们先规划一个最小但完整的项目结构mcp-content-server/ ├── package.json ├── src/ │ ├── index.js # MCP Server 入口 │ ├── contentService.js # 内容系统业务逻辑 │ └── data.js # 模拟数据层生产环境替换为数据库这里将“业务逻辑”和“MCP 工具定义”分开是为了模拟真实工程MCP 工具只是业务系统的“暴露层”真正的数据校验、权限控制、业务处理应该在 contentService 中完成。这样即使未来不通过 MCP而是通过 HTTP API 访问业务逻辑也能复用。3. MCP 核心原理拆解3.1 整体架构Client、Server、TransportMCP 协议定义了三个核心角色MCP Host用户使用的 AI 客户端程序比如 Claude Desktop、Codex、自研的 Web 应用等。它负责接收用户指令并向模型提供上下文和工具列表。MCP Client运行在 Host 内部负责与 MCP Server 建立连接、发现工具列表、发起调用请求。MCP Server独立的服务进程对外暴露 Tools、Resources、Prompts 等能力。通过 Transport 与 Client 通信。Transport 是传输层目前最常见的两种方式是stdioClient 启动一个子进程通过标准输入输出与 Server 通信。适合本地开发场景。HTTP/SSEServer 作为一个 HTTP 服务Client 通过 HTTP 请求调用。适合远程生产环境。在内容系统开发中本地调试通常用 stdio生产部署推荐 HTTP 模式方便水平扩展和权限控制。协议通信的示意流程Client 启动后连接 MCP Server。Server 返回能力列表包括有哪些工具、每个工具的参数定义。用户向 AI 发出自然语言指令。模型根据指令选择工具生成参数。Client 通过 MCP 协议调用 Server 的对应工具。Server 执行业务逻辑并返回结构化结果。模型基于结果生成最终回答。3.2 核心原语Tools、Resources、PromptsMCP 协议中Server 主要向模型暴露三类能力Tools工具让模型执行某个动作。比如“创建文章”“查询订单”。工具通常需要定义参数并由模型根据用户指令自动填充。工具调用是动态的有副作用必须由模型显式触发。Resources资源向模型提供数据文件、配置信息、上下文内容。资源是只读的比如“站点配置”“商户信息”。资源可以通过 URI 定位。Prompts提示词模板可复用的提示词模板帮助模型处理特定任务比如“内容审核模板”“订单处理模板”。在 MCP 内容系统中最常用的是 Tools。我们后续实战代码会重点展示 Tools 的设计和实现。3.3 客户端配置文件.mcp.json要让 AI 客户端能够找到并启动 MCP Server需要在客户端配置文件中注册 Server。不同客户端的配置文件名和位置可能不同但结构类似。以常见的 MCP JSON 配置为例{ mcpServers: { content-server: { command: node, args: [/absolute/path/to/mcp-content-server/src/index.js], env: {} } } }mcpServers配置列表的固定键名。content-server自定义的 Server 名称建议见名知意。command启动命令本地 Node 服务通常填node。args传给命令的参数这里必须是src/index.js的绝对路径。env环境变量比如数据库连接串、密钥等敏感信息不要在代码里硬编码。需要注意的是本地 stdio 方式中command和args要保证能直接以子进程方式运行。如果填错路径客户端连接 Server 时会立即失败。3.4 stdio 与 HTTP/SSE 传输方式stdio 模式适合开发和本地工具优点是启动简单、进程隔离安全缺点是只能本地使用不能远程部署。HTTP/SSE 模式则适合生产环境。MCP Server 以 HTTP 服务方式启动Client 通过 URL 连接可以配置鉴权、限流、日志等中间件。如果你的内容系统面向多个商户、多个 AI 客户端建议优先考虑 HTTP 模式。本文实战代码先用 stdio 演示重点让读者理解工具注册与调用逻辑。4. 实战从零构建 MCP 内容系统4.1 初始化项目与依赖先创建一个目录并初始化 Node.js 项目mkdir mcp-content-server cd mcp-content-server npm init -y然后安装 MCP SDK 和 Zod用于参数校验npm install modelcontextprotocol/sdk zod修改package.json加入type: module方便使用 ESM 语法{ name: mcp-content-server, version: 1.0.0, type: module, main: src/index.js, scripts: { start: node src/index.js }, dependencies: { modelcontextprotocol/sdk: ^0.6.0, zod: ^3.22.4 } }这里依赖版本以你安装时 npm 实际解析到的版本为准建议锁定版本号避免升级导致的不兼容。4.2 设计数据模型本文模拟一个支持多商户的内容付费平台。核心数据有三块商户、文章、订单。文件src/data.jsexport const db { merchants: new Map([ [m001, { id: m001, name: 科技星球, status: active }], [m002, { id: m002, name: 设计笔记, status: active }] ]), articles: new Map([ [ a1001, { id: a1001, merchantId: m001, title: 聊聊MCP对内容系统开发的影响, content: 这是一篇示例文章正文用于演示 MCP 内容系统。, status: published, isPaid: true, price: 19.9, createdAt: 2025-03-01T10:00:00.000Z } ] ]), orders: new Map([ [ o1001, { id: o1001, merchantId: m001, articleId: a1001, amount: 19.9, status: paid, createdAt: 2025-03-05T12:00:00.000Z } ] ]) };生产环境中这里的 Map 应替换为 MySQL、PostgreSQL、MongoDB 等数据库并通过数据库 WHERE 条件做租户隔离。这里用 Map 是为了让示例可以独立运行读者可以先把注意力放在 MCP 逻辑上。4.3 编写内容业务服务这一层负责真正的业务校验和处理MCP 工具只负责参数转发。这样可以保证业务逻辑独立于 MCP 协议将来增加 Web API 或其他接入方式时不需要重写。文件src/contentService.jsimport { db } from ./data.js; export const contentService { listArticles(merchantId, status) { let articles [...db.articles.values()]; if (merchantId) { articles articles.filter((a) a.merchantId merchantId); } if (status) { articles articles.filter((a) a.status status); } return articles.map((a) ({ id: a.id, merchantId: a.merchantId, title: a.title, status: a.status, isPaid: a.isPaid, price: a.price })); }, createArticle({ merchantId, title, content, isPaid false, price 0 }) { const merchant db.merchants.get(merchantId); if (!merchant || merchant.status ! active) { const err new Error(商户不存在或已停用: ${merchantId}); err.code MERCHANT_NOT_FOUND; throw err; } if (!title || title.length 2) { throw new Error(文章标题长度不能少于2个字符); } if (isPaid (!price || price 0)) { throw new Error(付费内容必须设置大于0的价格); } const id a${Date.now()}; const article { id, merchantId, title, content, isPaid, price: isPaid ? price : 0, status: draft, createdAt: new Date().toISOString() }; db.articles.set(id, article); return article; }, configurePaidContent(articleId, { isPaid, price }) { const article db.articles.get(articleId); if (!article) { throw new Error(文章不存在: ${articleId}); } if (isPaid (!price || price 0)) { throw new Error(付费内容价格必须大于0); } article.isPaid isPaid; article.price isPaid ? price : 0; return article; }, listOrders(merchantId, status) { let orders [...db.orders.values()]; if (merchantId) { orders orders.filter((o) o.merchantId merchantId); } if (status) { orders orders.filter((o) o.status status); } return orders; }, getMerchantStats(merchantId) { const articles [...db.articles.values()].filter((a) a.merchantId merchantId); const orders [...db.orders.values()].filter( (o) o.merchantId merchantId o.status paid ); const paidArticles articles.filter((a) a.isPaid); return { merchantId, articleCount: articles.length, publishedCount: articles.filter((a) a.status published).length, paidArticleCount: paidArticles.length, paidOrderCount: orders.length, paidRevenue: orders.reduce((sum, o) sum o.amount, 0) }; } };在不同业务中这里的校验规则会更多比如标题查重、图片封面校验、内容合规检查等。多商户系统还要额外校验操作者是否有该商户的管理权限。4.4 编写 MCP Server 入口这是最关键的部分。我们用modelcontextprotocol/sdk创建一个 MCP Server注册 5 个工具list_articles查询文章列表。create_article创建文章草稿。configure_paid_content配置付费内容。list_orders查询商户订单。get_merchant_stats查询商户内容数据概况。文件src/index.jsimport { McpServer } from modelcontextprotocol/sdk/server/mcp.js; import { StdioServerTransport } from modelcontextprotocol/sdk/server/stdio.js; import { z } from zod; import { contentService } from ./contentService.js; const server new McpServer({ name: mcp-content-server, version: 1.0.0, capabilities: { tools: {} } }); server.tool( list_articles, { merchantId: z.string().optional().describe(商户ID不传则返回全部), status: z.enum([draft, published]).optional().describe(文章状态) }, async ({ merchantId, status }) { const articles contentService.listArticles(merchantId, status); return { content: [{ type: text, text: JSON.stringify(articles, null, 2) }] }; } ); server.tool( create_article, { merchantId: z.string().describe(商户ID), title: z.string().describe(文章标题), content: z.string().describe(文章正文), isPaid: z.boolean().default(false).describe(是否为付费内容), price: z.number().min(0).default(0).describe(价格元付费内容必填) }, async ({ merchantId, title, content, isPaid, price }) { const article contentService.createArticle({ merchantId, title, content, isPaid, price }); return { content: [ { type: text, text: 文章创建成功ID${article.id}当前状态${article.status} } ] }; } ); server.tool( configure_paid_content, { articleId: z.string().describe(文章ID), isPaid: z.boolean().describe(是否启用付费), price: z.number().min(0).default(0).describe(价格元) }, async ({ articleId, isPaid, price }) { const article contentService.configurePaidContent(articleId, { isPaid, price }); return { content: [ { type: text, text: 付费配置已更新文章「${article.title}」${ article.isPaid ? 价格为 ${article.price} 元 : 为免费内容 } } ] }; } ); server.tool( list_orders, { merchantId: z.string().describe(商户ID), status: z.string().optional().describe(订单状态如 paid) }, async ({ merchantId, status }) { const orders contentService.listOrders(merchantId, status); return { content: [{ type: text, text: JSON.stringify(orders, null, 2) }] }; } ); server.tool( get_merchant_stats, { merchantId: z.string().describe(商户ID) }, async ({ merchantId }) { const stats contentService.getMerchantStats(merchantId); return { content: [{ type: text, text: JSON.stringify(stats, null, 2) }] }; } ); async function main() { const transport new StdioServerTransport(); await server.connect(transport); console.error(mcp-content-server 已通过 stdio 启动); } main().catch((err) { console.error(err); process.exit(1); });代码说明McpServer是 SDK 提供的高层封装简化了工具注册流程。每个server.tool()的第一个参数是工具名第二个参数是 Zod 参数定义第三个参数是异步处理函数。返回值必须是{ content: [{ type: text, text: ... }] }这种结构这是 MCP 协议的规范格式。这里特意用console.error打日志因为 stdio 模式中 stdout 是协议通道不能用console.log输出业务日志否则会把协议报文“污染”导致客户端解析失败。如果你的 SDK 版本较新可能会看到registerTool()等不同写法建议以官方文档为准逻辑是相同的。4.5 注册集成到 AI 客户端本地开发时可以把 MCP Server 注册到支持 MCP 配置的 AI 客户端中。通用 JSON 配置如下{ mcpServers: { content-server: { command: node, args: [/absolute/path/to/mcp-content-server/src/index.js], env: {} } } }配置完成后启动 AI 客户端客户端会拉起 Node 子进程与我们的 MCP Server 建立连接。随后可以在对话中直接说“查询 m001 商户下的所有已发布文章”“给 m001 商户创建一篇标题为《MCP 内容系统实战》的文章”“把文章 a1001 设置为付费内容价格 29.9 元”“查询 m001 商户的付费收入和订单数量”模型会根据工具描述自动选择调用对应工具。4.6 运行调试与验证命令行直接运行npm start如果一切正常控制台会输出mcp-content-server 已通过 stdio 启动不过直接手动运行 stdio 模式终端会处于等待状态因为 MCP 客户端还没与它通信。为了调试工具调用推荐使用 MCP Inspectornpx modelcontextprotocol/inspector node src/index.js它会打开一个调试面板可以看到 Server 注册了哪些工具、每个工具的参数结构也可以手动模拟调用这在排查“工具注册不上”“参数校验失败”时非常有用。如果是接入自研网站后端也可以把 MCP 工具集理解为一组“AI 可调用的内部接口”在 Web 管理后台中增加一个聊天窗口由后端代理与 MCP Server 通信。5. 常见问题与排查思路问题现象常见原因解决思路客户端中看不到工具或提示 Unknown toolSDK API 版本差异或 Server 启动失败先命令行直接跑一遍确认无报错再用 MCP Inspector 查看工具列表最后检查客户端配置路径启动后客户端立即断开stdio 协议通道被日志污染检查代码中是否误用console.log输出业务日志统一改为console.error工具调用提示参数校验失败Zod schema 与模型生成的参数不匹配检查工具名和参数类型给每个参数加describe描述帮助模型正确生成参数多商户数据串号查询时没有强制带 merchantId或 service 层未做过滤所有数据访问强制携带商户上下文服务端二次校验资源归属生产环境连接超时使用了 stdio 模式远程访问或 Server 启动耗时过长生产环境改为 HTTP/SSE 传输优化依赖加载必要时提前构建打包5.1 工具注册不上、模型找不到工具如果你在 AI 客户端中已经注册了 MCP Server但对话时模型提示找不到某个工具优先级最高的排查顺序是手动运行node src/index.js确认进程能正常启动不报语法错误或依赖缺失。使用 MCP Inspector 连接 Server看工具列表是否包含预期工具。如果 Inspector 中也看不到多半是 SDK 版本 API 变化查看官方文档调整注册方式。如果 Inspector 能看到但客户端看不到检查客户端配置里的命令和参数路径是否正确并重启客户端。5.2 启动后客户端立即断开这类问题常见于 stdio 模式。MCP 通过 stdout 按行传输 JSON-RPC 消息如果在代码里用console.log打印普通文本这些文本会被客户端当成协议消息去解析导致解析失败、连接断开。排查方法搜索代码中的console.log如果要输出业务日志一律改成console.error因为 stderr 不影响协议通道。5.3 工具调用时模型传参不对模型并不是“人”它生成参数依赖工具定义。如果你的参数定义里类型模糊比如价格字段用了普通的z.string()而不是z.number()模型就可能传错。建议给每个参数写清晰的describe例如describe(价格元付费内容必填)。用z.boolean().default(false)给可选项赋默认值。用z.enum([draft, published])约束状态枚举而不是让模型自由发挥。5.4 多商户数据串号多商户系统开发中数据串号是必须警惕的问题。最典型的情况是查询文章列表时没有传merchantId工具返回了全部商户的文章或者传了merchantId但 service 层没有按这个字段过滤。在 MCP 工具设计中更安全的做法是对需要商户隔离的工具强制要求merchantId参数不允许可空。service 层收到请求后先校验商户状态再做数据查询。涉及订单、收益等敏感数据时还要校验调用者的实际身份不能只相信参数里的商户 ID。5.5 生产环境连接超时本地 stdio 模式没问题但部署到服务器后连接超时通常是因为客户端从远程连接一个 stdio 进程是不现实的。生产环境应改用 HTTP/SSE 模式的 MCP Server把 Server 部署为一个独立服务Client 通过 URL 远程连接并配合鉴权、限流、HTTPS 等手段保证安全。6. 最佳实践与工程建议6.1 工具集设计原则设计 MCP Tools本质上是给 AI 设计一套“API 文档”但比普通 API 更依赖描述。因为普通 API 是开发者自己看的而 MCP 工具是模型看的参数描述写得越清楚模型调用的准确率越高。推荐遵循下面几个原则一个工具只做一件事。比如“创建文章”和“发布文章”分成两个工具而不是合成一个“创建并发布”。工具名用动词开头如create_article、list_orders让模型一眼看出用途。参数可选性要克制。能少用可选项就少用太多的可选项会让模型难以决策。对涉及金额、状态变更的工具在返回结果中给出确认信息方便模型向用户复述。6.2 安全与权限边界MCP 工具一旦暴露给 AI就相当于一条“可被自动调用的业务接口”。需要特别注意安全边界不要在高权限下运行 MCP Server应使用最小权限用户。重要的写操作要加操作确认或审批流程比如发布文章、修改价格可以在业务服务层记录操作人和操作时间。涉及支付、退款类工具不能只依赖参数必须在服务端从数据库中读取原始订单数据进行校验。不要把数据库密码、云账号密钥直接写入env或代码中应使用密钥管理服务。6.3 多商户隔离多商户系统的 MCP 工具开发数据隔离是第一优先级。常见做法有三种参数隔离工具强制要求merchantId并在 service 层做过滤。上下文隔离在请求头或上下文中注入商户身份工具从上下文读取而不是信任模型传参。数据库隔离每个商户独立数据库或独立 schema从物理层面隔离。在示例代码中我们使用了“参数隔离 service 层校验”。生产环境中更推荐引入身份认证和上下文传递让 MCP Server 从连接凭证中识别当前登录用户和所属商户避免模型传错商户 ID。6.4 日志与可观测性MCP Server 是 AI 客户端与业务系统之间的桥梁日志对排查问题很重要。建议记录每个工具的调用时间、参数摘要、返回结果状态。从哪个客户端连接、对应哪些商户。异常堆栈和错误码方便归因。敏感字段脱敏例如手机号、身份证号、支付订单详情等。日志输出使用结构化格式JSON Lines方便采集到日志平台。console.error在 stdio 模式下只能服务本地日志生产环境建议接入日志库或中间件。6.5 测试与发布MCP Server 也可以像普通服务一样做测试。建议单元测试业务服务层覆盖参数校验、多商户过滤等关键逻辑。集成测试 MCP Server用 MCP 客户端连接 Server调用工具并断言返回结果。使用 MCP Inspector 做人工冒烟测试验证工具列表和参数 schema。发布时锁定 SDK 版本升级前先跑一遍测试用例防止协议变化导致工具注册失败。7. 总结与学习路线7.1 本文要点回顾本文从 MCP 概念出发梳理了 MCP 在内容系统开发中的定位并基于一个“内容付费 多商户”的业务场景从零实现了一个完整的 MCP Content Server。核心知识点包括MCP 协议解决的是模型与外部工具、数据源的标准化连接问题。MCP 工具的参数描述决定模型调用准确率需要像设计接口文档一样设计。stdio 模式适合本地开发生产环境应使用 HTTP/SSE 模式。多商户系统下数据隔离必须在业务服务层强制实现不能只依赖模型自觉。日志、权限、审批流是 MCP 工具落地生产环境的底线。7.2 下一步学习路线如果你刚开始接触 MCP建议先跑通本文的最小示例然后用 MCP Inspector 多调试几次感受工具注册和调用过程接着可以尝试把业务服务层替换为真实数据库增加 JWT 鉴权和商户上下文传递再往后可以研究 HTTP/SSE 模式部署、LangChain 与 MCP 的集成、RAG 内容检索工具等方向。MCP 内容系统开发并不是一个多么高深的技术它的核心是“定义清晰、控制安全、保持简单”。只要沿着“工具设计 → 业务校验 → 数据隔离 → 可观测性”这条链路走下去你也能很快把 AI 能力真正接进自己的内容系统和网站后台里。如果你正打算把 AI 能力接入内容系统建议先把本文的示例跑起来再对照你项目的业务流程设计工具集。