MCP Logger 7395bed3

MCP开发工具

提供方 timotholt

开发工具 未标注 会话登录 社区 / 第三方 ClaudeWindsurfVS Code

mcp-logger是一个模型上下文协议(MCP)服务器和客户端工具包,用于从浏览器和Node.js进程捕获结构化日志消息,并将其转发给MCP感知工具,同时提供实时Web仪表板和本地调试支持。

一句话选型结论

按资料字段整理

MCP Logger 7395bed3 属于开发工具类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude、Windsurf、VS Code,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

日志管理JavaScript本地部署实时监控结构化日志Web仪表板开发工具

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude、Windsurf、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Windsurf 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Logger 7395bed3当前 4 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方timotholt上游标注的维护方 timotholt
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.9 KB
来自项目仓库与上游目录的原文,未做删改

mcp-logger

Overview

mcp-logger is a Model Context Protocol (MCP) server and companion client
toolkit that captures structured log messages from browsers and Node.js
processes. It forwards those logs to MCP-aware tools (Claude, VS Code, Windsurf,
etc.), provides a live web dashboard, and keeps native console output intact for
local debugging.

Goals

  • Collect logs from many clients (browser or Node) and differentiate their
    sources.
  • Preserve native console.* behavior while streaming structured entries to the
    MCP server.
  • Offer real-time viewing (web UI + MCP logging notifications) and historical
    retrieval via fetch APIs.
  • Support buffer clearing and named sessions so test runs are easy to diff.
  • Stay transport-agnostic and open for community adoption.

Feature Set

  1. MCP Logging Server – stdio-compatible server with optional HTTP/WebSocket
    bridge, ring-buffer storage, and tool APIs (push_log, fetch_logs,
    clear_logs, set_session).
  2. Web Dashboard – Vite-powered SPA served by the server for live log
    monitoring, filtering, session control, and quick links to health/meta/events
    endpoints plus the in-browser demo.
  3. Client Adapters – Browser and Node helpers that wrap console.log, send
    structured payloads to the server, and retain native console output.
  4. Session & Client Tagging – Each log includes clientId and sessionId
    metadata for filtering and grouping.
  5. Structured Schema – Shared definitions for levels, payload shape, and
    validation logic to keep all packages in sync.

Architecture```

┌────────────────────────┐ ┌───────────────────────────┐
│ Browser Client │ │ Node Client │
│ @mcp-logger/browser │ │ @mcp-logger/node │
│ • console hook │ │ • console hook │
│ • HTTP/WebSocket push │ │ • HTTP/WebSocket/stdio │
└──────────┬─────────────┘ └──────────┬────────────────┘
│ │
▼ ▼
┌────────────────────────────────────────────────────┐
│ mcp-logger Server │
│ • MCP stdio transport │
│ • HTTP + WebSocket endpoints │
│ • Ring buffer + sessions │
│ • Tools: push_log, fetch_logs, clear_logs, │
│ set_session │
│ • MCP logging notifications │
└──────────┬────────────────────────────┬────────────┘
│ │
▼ ▼
┌────────────────────┐ ┌──────────────────────┐
│ Web Dashboard │ │ MCP Clients (IDE, AI)│
│ SSE / WebSocket │ │ logging/fetch tools │
└────────────────────┘ └──────────────────────┘


## Server Components

- **Transport Layer** – stdio MCP interface plus optional HTTP server with
  WebSocket/SSE endpoints for browser clients and dashboard.
- **Ring Buffer Store** – Configurable in-memory circular buffer that stores
  logs, maintains cursors, and tracks dropped entries when capacity is
  exceeded.
- **Session Manager** – Issues `sessionId` tokens, records start/end metadata,
  and exposes session list to clients.
- **Tool Handlers**
  - `logging/push` – validate payload, stamp timestamp/sequence, place entry in
    buffer, and broadcast notifications.
  - `logging/fetch` – filter by level, client, session, time window, and return
    paginated results with a cursor.
  - `logging/clear` – reset buffer (optionally starting a new default session)
    and notify subscribers.
  - `logging/set-session` – create or rename a session scope and hand back the
    active `sessionId`.
- **Notification Dispatcher** – Emits MCP logging notifications and broadcasts
  to WebSocket/SSE subscribers.

## Data Model```jsonc
{
  "id": "uuid",
  "timestamp": "ISO-8601 string",
  "sequence": 123456,
  "level": "trace|debug|info|warn|error|fatal",
  "clientId": "renderer-web",
  "sessionId": "run-48",
  "message": "Fog renderer ready",
  "data": { "module": "fog", "details": { "cells": 2048 } },
  "source": "browser-http"
}

Logging Flow

  1. Client adapter patches console.* and forwards structured payloads to the
    server.
  2. Server validates payload, assigns sequence number, stores in ring buffer, and
    emits MCP notification + WebSocket update.
  3. MCP clients (Claude, IDE) use logging/fetch to retrieve batches or stream
    live messages; dashboard updates in real time.
  4. Users or automations call logging/clear / logging/set-session to reset or
    tag test runs, ensuring clean diffs between sessions.

Client Adapters

  • Browser (@mcp-logger/browser)
  • attachLogger({ endpoint, clientId, sessionId?, levels?, enabled? }) – full
    console hook for application integration.
  • Lightweight helper mcpLog(message, session?, client?) for quick scripts or
    demos. Defaults to '.' for session/client; passing new values updates the
    stored identifiers before sending. Uses Fetch batching and falls back to XHR
    (ES5-compatible build).
  • Built output transpiled to ES5 (no optional chaining, arrow functions, etc.)
    so it can run in legacy engines.
  • Respects runtime feature flags so logging can be toggled without reload.
  • Node (@mcp-logger/node)
  • Similar API; preserves stdout/stderr; optional hooks for unhandled
    rejections or custom metadata injectors.
  • Both adapters ensure clientId defaults (hostname + PID or URL) while allowing
    explicit overrides for multi-client deployments.

Web Dashboard

  • Served at the server root with static assets built by Vite.
  • Sticky header surfaces metadata plus quick links to /health, /meta,
    /events, and /demo, alongside a "Clear logs" button.
  • Connects via SSE/WebSocket for live updates.
  • UI features: level toggles, client/session filters, text search, timeline
    graph, clear/session buttons, JSON export, theme toggle.
  • Uses MCP tool endpoints under the hood for destructive actions (clear, start
    session).

Browser Demo

Visit /demo to see the mcpLog helper in action. The page imports the
browser bundle, throws immediately if it fails to load, and sends an info
message every three seconds:```html
<script src="/client/index.js"></script>
<script>
mcpLog('Random message', 'demo-session', 'demo-browser')
</script>


Providing `session`/`client` arguments updates the stored identifiers; omit them
to keep previous values (defaults to `&#x27;.&#x27;`).

## Configuration

- Environment variables / config file
  - `LOG_BUFFER_SIZE` – maximum entries kept in memory.
  - `LOG_HTTP_PORT` – optional HTTP/WebSocket listener.
  - `LOG_AUTH_TOKEN` – bearer token required for remote pushes.
  - `LOG_PERSIST_PATH` (future) – directory for NDJSON archival.
- IDE auto-start (VS Code/Windsurf)
  - Add an entry under `mcpServers` pointing to `node packages/server/index.js`
    with the appropriate `cwd`.
- Optional npm scripts: `dev` (watch mode), `start` (prod server), `dashboard`
  (run web UI standalone).
  - `LOG_BROWSER_TARGET=es5` (build flag controlling Babel preset for legacy
    bundle).

## Local Development Without Workspaces

The repo now relies on plain npm with direct `file:` links instead of
workspaces. Use the project root scripts to keep package builds in sync:```bash
npm install
npm run build:shared
npm run build:server
npm run build:browser
npm run build:node
npm run build:dashboard

The npm run build shortcut chains those commands in order. Each package can
also be built or tested in isolation via npm run --prefix packages/.

Roadmap

  1. Scaffold repo (workspaces, linting, testing, GitHub workflows).
  2. Implement shared schema utilities and unit tests.
  3. Build server MVP (MCP stdio + HTTP/WebSocket, ring buffer, tool handlers).
  4. Release browser & Node adapters with console hooking and transport logic.
  5. Ship basic web dashboard (live table, filters, clear/session controls).
  6. Add persistence/export, auth hooks, CLI utilities, and documentation.
  7. Publish packages to npm and prepare GitHub release templates.

Status

  • Spec drafted – implementation in progress.

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
MCP Logger 7395bed3 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Logger 7395bed3 怎么在 Claude、Windsurf、VS Code 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Logger 7395bed3 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Logger 7395bed3 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

MCP Logger 7395bed3 支持哪些客户端?

资料标注支持 Claude、Windsurf、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Logger 7395bed3 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 日志管理、JavaScript、Claude、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。