MCP 服务构建指南
指导 Agent 把外部 API 或业务服务设计成可靠的 MCP 服务，覆盖工具设计、TypeScript/Python 实现、测试和安全边界。
技能说明
Anthropic 官方 MCP Server Development Guide，帮助把外部 API 或服务设计成可被 Agent 稳定调用的 MCP 工具。它要求先读 MCP 和目标 API 的官方文档，再实现、测试和评估；不会替你保管密钥，也不应直接把未经审查的写入或删除操作暴露给 Agent。
关于此技能
Anthropic 官方 MCP Server Development Guide，帮助把外部 API 或服务设计成可被 Agent 稳定调用的 Model Context Protocol 服务。
核心能力
工具与接口设计
规划清晰的工具命名、参数约束、分页、结构化输出和可操作的错误信息，让 Agent 更容易发现和组合工具。
TypeScript 与 Python 实现
提供 MCP SDK、认证、响应格式、异步 I/O、Transport 和项目结构的实现方向。
测试与评估
要求用 MCP Inspector 验证编译和运行，并设计只读、可验证、稳定的评估问题来检查工具是否真的有用。
适用场景
把业务 API 接入 Agent
把 CRM、工单、知识库、数据库或内部服务包装成可调用的 MCP 工具。
设计高质量 MCP 工具
在开发前确定工具边界、输入输出、分页、错误提示和读写风险，减少 Agent 误用。
检查 MCP 服务质量
审查工具描述、类型、安全边界、测试覆盖和真实任务效果。
使用步骤
- 01
第一步：研究协议与业务 API
先阅读 MCP 规范和目标服务的官方 API 文档，明确认证、数据模型和需要支持的操作。
- 02
第二步：规划工具与安全边界
决定只读和写入工具、参数约束、分页、错误处理、权限和破坏性操作提示。
- 03
第三步：实现并验证
用 TypeScript 或 Python SDK 实现，运行构建、语法检查、MCP Inspector 和只读评估问题。
常见问题
适合哪些 Agent？+
Anthropic 仓库官方面向 Claude 相关产品；它采用 Agent Skills 格式，其他兼容客户端可以参考或移植，但具体支持取决于客户端。
会自动替我创建 MCP 服务吗？+
不会。它提供设计、实现和评估流程，实际代码仍需结合你的 API、认证和部署环境完成。
安全上最需要注意什么？+
先区分只读、可写和破坏性工具，限制权限并写清错误处理；不要把密钥写进技能、代码或日志。
许可证是什么？+
mcp-builder 技能目录提供 Apache 2.0 许可证文件；修改或分发时应保留许可和变更说明。
/plugin marketplace add anthropics/skills；/plugin install example-skills@anthropic-agent-skills