Back to MCP directory
publicPublicdnsLocal runtime

mcps-logger

MCP Server Logger是一个用于解决MCP服务器开发中console.log干扰协议通信问题的工具,它通过重定向日志到独立终端来保持通信纯净。

article

README

🚀 MCP 服务器日志记录器

MCP 服务器日志记录器为 stdio MCP 服务器提供 console.log 功能,有效解决开发中日志干扰协议通信的问题。

npm 版本 许可证: MIT

🚀 快速开始

问题背景

在开发使用 stdio 运输协议的 MCP(模型上下文协议)服务器时,console.log 会干扰与协议的通信。例如,当您在 MCP 检查工具 npx @modelcontextprotocol/inspector 中调用 MCP 服务器代码里的 console.log 时,通常会得到以下错误信息:

MCP 服务器错误: JSON 解析中意外的标记 S 在位置 0

解决方案

此包修补了控制台方法(logwarnerrordebug),并将日志重定向到单独的终端。

点击查看相关演示

使用步骤

启动记录器

在您希望查看日志的终端中启动记录器:

npx mcps-logger

安装记录器

在您的 MCP 服务器中安装记录器:

npm install mcps-logger

添加到服务器入口文件

将其添加到您的 MCP 服务器入口文件中:

import "mcps-logger/console";

或者如果您只想在开发模式下使用:

if (process.env.NODE_ENV !== "production") {
    import("mcps-logger/console");
}

📄 许可证

本项目采用 MIT 许可证

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client