mcpField
M
MCP Server Logger

MCP Server Logger

本地服务
github.com/mlshv开发工具2382 周前更新

关于 MCP Server Logger

MCP Server Logger 是一个用于 stdio 传输 MCP 服务的日志工具。它将 console 方法的输出重定向到单独的终端,避免日志干扰协议通信,适合开发阶段使用。

主要功能

  1. 01重定向 console.log、warn、error、debug 输出
  2. 02日志显示在独立终端中
  3. 03通过 npm 包 mcps-logger 安装
  4. 04可仅在开发模式下启用

适用场景

  1. 01调试 stdio 传输的 MCP 服务
  2. 02避免 console.log 导致 MCP Inspector 报错

MCP 相关

该工具用于 stdio 传输的 MCP 服务开发,不向客户端暴露 MCP 工具或资源。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"mcps-logger": {
"command": "npx",
"args": [
"-y",
"mcps-logger"
]
}
}
}
启动命令npx -y mcps-logger

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmmcps-logger

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

MCP 服务日志记录器

用于 stdio MCP 服务的 console.log

npm version License: MIT

为什么?

使用 stdio 传输开发 MCP(Model Context Protocol)服务时,console.log 会干扰协议通信。

例如,在 MCP 服务代码中调用 console.log 时,通常会在 MCP inspector npx @modelcontextprotocol/inspector 中看到以下内容:

Error from MCP server: SyntaxError: Unexpected token S in JSON at position 0

解决方案

此软件包会修补 console 方法(log、warn、error、debug),并将日志重定向到单独的终端。

https://github.com/user-attachments/assets/33ff367e-74b4-48e8-9f04-0bcafbad5e00

用法

在要查看日志的终端中启动日志记录器:

npx mcps-logger

在 MCP 服务中安装日志记录器:

npm install mcps-logger

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

import "mcps-logger/console";

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

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

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。