
MCP Server Logger

2025.04.01
8
TypeScript日志记录调试工具开发效率
MCP Server Logger 是一个专为 stdio 传输的 MCP(Model Context Protocol)服务器设计的日志记录工具。它解决了在开发 MCP 服务器时,使用 console.log 会干扰协议通信的问题。通过重定向日志到单独的终端,开发者可以更清晰地查看日志信息,而不会影响 MCP 协议的通信。
View on GitHub
Overview
基本能力
产品定位
MCP Server Logger 是一个日志记录工具,专为 stdio 传输的 MCP 服务器设计,用于解决 console.log 干扰协议通信的问题。
核心功能
- 重定向 console.log、console.warn、console.error 和 console.debug 到单独的终端。
- 避免日志信息干扰 MCP 协议的通信。
- 支持开发和生产环境的灵活配置。
适用场景
- 开发 MCP 服务器时需要查看日志信息。
- 调试 MCP 服务器时避免日志干扰协议通信。
工具列表
mcps-logger
:主工具,用于启动日志记录服务。mcps-logger/console
:用于在 MCP 服务器中导入并重定向日志。
常见问题解答
- 问题:使用 console.log 时出现 JSON 解析错误。 解决方案:使用 mcps-logger 重定向日志到单独终端。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
安装教程
- 启动日志记录服务:
shell npx mcps-logger
- 在 MCP 服务器中安装 logger:
shell npm install mcps-logger
- 在 MCP 服务器入口文件中导入 logger:
typescript import "mcps-logger/console";
或仅在开发环境中使用:typescript if (process.env.NODE_ENV !== "production") { import("mcps-logger/console"); }
调试方式
- 启动日志记录服务后,查看日志信息是否正常输出到单独终端。
- 确保 MCP 服务器中的日志调用(如 console.log)不再干扰协议通信。