SuperAPI AI 工具集

mcp-2025-patterns

智能体与模型

查看项目

更新于 10-15 21:47

技能介绍

用途:该技能整理截至 2025 年底 Model Context Protocol(MCP)服务器设计、实现与集成的最佳实践,帮助开发者构建供 Claude Code 等宿主调用的 MCP 服务器。

主要能力:覆盖 MCP 架构基础(宿主、客户端层、多服务器),服务器组件(Tools 工具、Resources 资源、Prompts 提示模板、Notifications 通知),以及三类设计模式:单职责服务器、资源优先设计、按领域/动作分层组织工具。工具设计强调清晰的动作加名词命名、完整的 inputSchema 描述与约束、返回结构化且可预测的数据并附建议后续动作。

使用方式:资料给出基于 MCPServer 的示例代码,如 server.addTool、server.addResource 等调用形式;完整细节放在 references/ 目录,按需加载,其中 references/advanced-patterns.md 涉及安全、多服务器编排、性能、错误处理与测试模式。

适用场景:为 GitHub、Linear、Notion、图像生成、n8n 工作流、Playwright 浏览器自动化等不同领域分别构建聚焦的 MCP 服务器,并统一采用 mcp__<server>__<action> 命名、优雅降级与按任务选择合适 MCP 的集成策略。

限制:资料未提供具体安装命令、依赖版本、收费或价格信息,也未给出完整可运行项目结构;部分内容为示例性代码片段,实际实现需结合自身环境验证。