MCP 日志怎么记：既能排错又不泄露上下文

先给结论

记录工具名、请求标识、结果规模、耗时和错误类型，参数值按敏感级别选择性保留。

判断起点

定义调用标识、耗时、状态和脱敏后的错误记录。本地 stdio 服务部署简单，但依赖用户环境和本机权限；远程服务便于共享，却增加身份、租户隔离、网络超时和集中审计责任。选择传输方式时应先看使用边界。

推荐做法

日志服务于定位而不是永久保存全部上下文。建议记录请求标识、版本、动作、耗时、结果规模和错误类型，对参数按敏感级别脱敏。建立保存期限和删除流程，并实际验证异常堆栈不会意外打印令牌、文档原文或个人数据。

核验重点

• 服务声明的工具与实际权限是否一致
• 传输方式和凭据存储是否适合部署环境
• 失败、超时和返回数据是否可追踪

把检查结果写成可复测记录，至少包含日期、版本、环境、输入样例和结果。这样项目升级或需求变化后，团队可以判断原结论是否仍然成立。

进一步验证

对比方案时建立同一张评分表，只选择与当前任务有关的五到七项指标，并事先确定不可接受条件。先淘汰环境或权限不匹配的候选，再比较效果和成本，避免因为某个亮点功能掩盖部署、维护或数据风险。

常见误区

完整保存提示词、文件内容和令牌会让日志成为新的高风险数据源。同时不要把“能够运行”直接解释为“适合生产”，个人试验与长期服务对权限、稳定性、监控和维护的要求不同。

如何形成自己的结论

围绕本文主题准备一个代表性样例，先记录当前方案的基线，再使用候选方案重复同一任务。比较最终正确性、人工修正、耗时、资源或调用成本以及失败恢复情况；如果结果会影响重要数据或线上服务，应先在隔离环境验证。

留下可复查记录

权限评估从最坏副作用倒推：工具能读取什么、能写到哪里、能否联网、能否触发外部操作。只读和写入分开授权，敏感动作保留确认，并使用测试账号或隔离目录演练。权限便利性不能高于数据和服务恢复能力。

参考来源

• MCP Specification

本文根据以上公开项目整理，不复制 README 全文。仓库功能、许可证和维护状态可能变化，使用或分发前请再次查看原始页面。