返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端