MCP服务器日志调试工具

一个用于捕获MCP服务器stdin/stdout/stderr和信号的调试包装器,便于集成开发和故障排除。

  • by megmogmog1965
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 megmogmog1965/mcp-server-logger

使用说明

mcp服务器记录器

模型上下文协议(MCP)服务器的调试包装器,它捕获stdin/stdout/stderr并将信号记录到日志文件中,从而更容易进行MCP集成的故障排除和开发。

注:

  • 此工具仅适用于基于macOS和Unix的操作系统。不支持Windows
  • 仅支持STDIO传输。不支持SSE。

如何构建(用于开发)

npm install
npm run build

如何运行(命令)

mcp服务器记录器可以直接从命令行运行。它充当任何MCP服务器命令的包装器,将所有stdin/stdout/stderr和信号活动记录到指定的日志文件中。

npx mcp-server-logger "{log-file-path}" {command} {args...}

如何在Claude for Desktop上运行

要将此服务器与Claude Desktop一起使用,您需要在Claude Desktop配置文件中对其进行配置。此文件位于:

~/Library/Application Support/Claude/claude_desktop_config.json

配置示例:

{
  "mcpServers": {
    "filesystem": {
      "command": "/{path-to-bin}/npx",
      "args": [
        "mcp-server-logger",
        "/{path-to-user-home}/mcp-server.log",
        "/{path-to-bin}/npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "{path-to-user-home}/Desktop/"
      ]
    }
  }
}

此配置注册了一个名为“文件系统”的MCP服务器,该服务器通过调试器包装器运行MCP文件系统服务器。调试器捕获所有stdin/stdout/stderr,并将信号发送到指定输出路径的日志文件中,以便于故障排除和开发。