MCP Server 设计

这页偏开发者实现视角。

设计原则

• 单一领域：一个 Server 聚焦一类能力。
• 最小暴露：只暴露必须的 tool/resource。
• 明确契约：输入输出字段稳定、可验证。

Tool 设计建议

• 命名直观，如 get_release_status。
• 参数类型明确，避免“万能字符串”。
• 返回结构化对象，便于下游评测与日志分析。

Resource 设计建议

• 支持分页或分段读取。
• 对高体量内容提供摘要资源。
• 返回时附带版本和时间戳。

Prompt 设计建议

• 按任务分类，不按团队分类。
• 每个 prompt 要有适用边界。
• 标记风险级别（低/中/高）。

错误处理建议

• 错误信息分三层：用户可读、开发可诊断、系统可追踪。
• 对可重试错误和不可重试错误做区分。

性能建议

• 热路径缓存。
• 慢调用超时和熔断。
• 并发上限控制。