discover-mcp

MCP 技能发现

自动提供全面的 MCP 服务开发、工具设计和测试技能。

此技能的激活条件

在以下情况下，此技能会自动激活：

• 构建 MCP 服务（TypeScript 或 Python）
• 设计 MCP 工具、资源或提示词
• 选择 MCP 传输方式（stdio、SSE、Streamable HTTP）
• 实现基于 MCP 的 JSON-RPC 2.0
• 使用 Inspector 或自动化测试测试 MCP 服务
• 调试 MCP 协议或传输问题
• 发布或部署 MCP 服务

可用技能

快速参考

MCP 类别包含 3 项专门技能：

1. mcp-server-fundamentals - 架构、传输方式、工具／资源／提示词原语、SDK 设置
2. mcp-tool-design - 工具命名、架构、错误处理、注解、渐进式披露
3. mcp-testing - Inspector、单元测试、集成测试、传输调试、CI/CD

加载完整类别详情

查看完整说明和工作流：

Read ../mcp/INDEX.md

这会加载完整的 MCP 类别索引，其中包含：

• 详细的技能说明
• 每项技能的使用触发条件
• 常见工作流组合
• 相关技能的交叉引用

加载特定技能

根据需要加载单项技能：

服务端架构和设置

Read ../mcp/mcp-server-fundamentals.md

工具设计和最佳实践

Read ../mcp/mcp-tool-design.md

测试和调试

Read ../mcp/mcp-testing.md

常见工作流

新建 MCP 服务

顺序：基础知识 -> 工具设计 -> 测试

Read ../mcp/mcp-server-fundamentals.md # 架构、传输方式、SDK Read ../mcp/mcp-tool-design.md # 设计工具接口 Read ../mcp/mcp-testing.md # 使用 Inspector、CI 进行测试

向现有服务添加工具

顺序：工具设计 -> 测试

Read ../mcp/mcp-tool-design.md # 命名、架构、错误 Read ../mcp/mcp-testing.md # 测试新工具

调试 MCP 问题

顺序：测试 -> 基础知识

Read ../mcp/mcp-testing.md # Inspector、传输调试 Read ../mcp/mcp-server-fundamentals.md # 生命周期、功能

与其他技能集成

MCP 技能通常会与以下技能组合使用：

API 技能（discover-api）：

• 封装 REST 或 GraphQL API 的 MCP 服务
• MCP 工具后端的身份验证

测试技能（discover-testing）：

• 全面的测试策略
• 契约测试模式

基础设施技能（discover-infra、discover-cloud）：

• 部署 MCP 服务
• 扩展 HTTP 传输方式

渐进式加载

此网关技能（约 170 行，约 1.5K 个 token）支持渐进式加载：

• 级别 1：网关自动加载（当前所在级别）
• 级别 2：加载类别 INDEX.md（约 2.5K 个 token），查看完整概览
• 级别 3：根据需要加载特定技能（每项约 2–3K 个 token）

总上下文：1.5K + 2.5K + 技能 = 4–8K 个 token，而非加载所有内容所需的 12K+ 个 token。

快速入门示例

“构建 MCP 服务”： Read ../mcp/mcp-server-fundamentals.md

“为我的 API 设计 MCP 工具”： Read ../mcp/mcp-tool-design.md

“测试我的 MCP 服务”： Read ../mcp/mcp-testing.md

“调试我的 MCP 工具为何没有显示”： Read ../mcp/mcp-testing.md

后续步骤：运行 Read ../mcp/INDEX.md 查看完整类别详情，或使用上面的命令加载特定技能。