ejcho623/agent-breadcrumbs

ejcho623/agent-breadcrumbs

от ejcho623
MCP-сервер для логирования и наблюдаемости ИИ-агентов. Стандартизирует логи через кастомные схемы, собирает данные от разных клиентов (Codex, Claude, Cursor). Отправляет в JSONL, webhook или Postgr...

Agent Breadcrumbs 🍞

Lightweight logging & observability for agent work across clients (Codex, Claude, Cursor, ChatGPT, OpenClaw, and others).

https://github.com/user-attachments/assets/3eac31a8-107c-4a82-a14c-dcfa500dd1a9

What You Get

  • One MCP tool (log_work) that aggregates work done across different agents for single or multiple users.
  • Define your own logging structure with custom schemas (or use built-in profiles) once, and the MCP schema will guide clients to log with correct payloads.
  • This lets teams standardize logging once, then route data wherever they need it.
  • Multiple options for output sinks:
    • local JSONL
    • webhook
    • Postgres
  • Starter schema profiles for common use cases:
    • agent insights
    • delivery tracking
    • audit trail
    • knowledge capture
  • Simple dashboard app to view logged work.

Repository Layout

  • MCP server package (published): packages/mcp
  • Dashboard app (repo-local, not published): apps/dashboard

Quick Start (MCP)

Install and run with defaults:

npx -y agent-breadcrumbs

Use with an explicit config file:

У этого сервера пока нет списка инструментов.
0.1.3основная
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить ejcho623/agent-breadcrumbs:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "ejcho623-agent-breadcrumbs-5e7t7w5nv1": {
      "command": "npx",
      "args": [
        "-y",
        "agent-breadcrumbs",
        "--config",
        "/absolute/path/to/server-config.json"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "ejcho623-agent-breadcrumbs-5e7t7w5nv1": {
      "command": "npx",
      "args": [
        "-y",
        "agent-breadcrumbs",
        "--config",
        "/absolute/path/to/server-config.json"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "ejcho623-agent-breadcrumbs-5e7t7w5nv1": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agent-breadcrumbs",
        "--config",
        "/absolute/path/to/server-config.json"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"ejcho623-agent-breadcrumbs-5e7t7w5nv1\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"agent-breadcrumbs\",\"--config\",\"/absolute/path/to/server-config.json\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "ejcho623-agent-breadcrumbs-5e7t7w5nv1": {
      "command": "npx",
      "args": [
        "-y",
        "agent-breadcrumbs",
        "--config",
        "/absolute/path/to/server-config.json"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add ejcho623-agent-breadcrumbs-5e7t7w5nv1 -- npx -y agent-breadcrumbs --config /absolute/path/to/server-config.json

Либо через JSON-конфиг:

claude mcp add-json ejcho623-agent-breadcrumbs-5e7t7w5nv1 "{\"command\":\"npx\",\"args\":[\"-y\",\"agent-breadcrumbs\",\"--config\",\"/absolute/path/to/server-config.json\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add ejcho623-agent-breadcrumbs-5e7t7w5nv1 -- npx -y agent-breadcrumbs --config /absolute/path/to/server-config.json

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.ejcho623-agent-breadcrumbs-5e7t7w5nv1]
command = "npx"
args = ["-y", "agent-breadcrumbs", "--config", "/absolute/path/to/server-config.json"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите ejcho623/agent-breadcrumbs, а в поле команды запуска — строку ниже:
npx -y agent-breadcrumbs --config /absolute/path/to/server-config.json

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ejcho623-agent-breadcrumbs-5e7t7w5nv1": {
      "command": "npx",
      "args": [
        "-y",
        "agent-breadcrumbs",
        "--config",
        "/absolute/path/to/server-config.json"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "ejcho623-agent-breadcrumbs-5e7t7w5nv1": {
      "command": "npx",
      "args": [
        "-y",
        "agent-breadcrumbs",
        "--config",
        "/absolute/path/to/server-config.json"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например ejcho623-agent-breadcrumbs-5e7t7w5nv1.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: ejcho623-agent-breadcrumbs-5e7t7w5nv1
    command: npx
    args:
      - "-y"
      - "agent-breadcrumbs"
      - "--config"
      - "/absolute/path/to/server-config.json"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "ejcho623-agent-breadcrumbs-5e7t7w5nv1": {
      "command": "npx",
      "args": [
        "-y",
        "agent-breadcrumbs",
        "--config",
        "/absolute/path/to/server-config.json"
      ]
    }
  }
}

Похожие MCP-сервера

whdrnr2583-cmd/token-meter

whdrnr2583-cmd/token-meter

от whdrnr2583-cmd

MCP сервер для локального отслеживания токенов и стоимости Claude Code, Codex и Cursor. Анализирует JSONL файлы и показывает разбивку по проектам, моделям и MCP инструментам — без отправки данных в облако и без аккаунта.

TypeScript⭐ 1
alilxxey/openobserve-community-mcp

alilxxey/openobserve-community-mcp

от alilxxey

MCP сервер для OpenObserve Community Edition в режиме read-only через stdio и REST API. Выполняет поиск логов, просмотр схем потоков и дашбордов. Интегрируется с Claude и Codex для анализа данных OpenObserve без права записи.

Python⭐ 16
alimuratkuslu/byok-observability-mcp

alimuratkuslu/byok-observability-mcp

от alimuratkuslu

MCP сервер для запросов к observability-стекам (Grafana, Prometheus, Kafka UI, Datadog). Данные хранятся локально — ключи не покидают машину. Разработчики и SRE анализируют метрики, алерты и логи прямо из Claude Code, Codex или любого MCP клиента без настройки инфраструктуры.

TypeScript⭐ 4
last9/last9-mcp-server

last9/last9-mcp-server

официальный

от last9

Last9 MCP-сервер подключает AI-агентов (Claude, Cursor, Windsurf) к вашим производственным данным observability — логам, метрикам, трейсам, алертам. Без установки бинарников, через OAuth. Полезен S...

Go⭐ 63
Grafana MCP

Grafana MCP

официальный

от grafana

MCP сервер для интеграции с Grafana: управляйте дашбордами, выполняйте запросы к Prometheus, Loki, CloudWatch и другим источникам через MCP. Упрощает мониторинг, анализ метрик и логов — полезен для инженеров и DevOps.

Go⭐ 3577
rrmistry/tilt-mcp

rrmistry/tilt-mcp

от rrmistry

Интегрирует Tilt с LLM-ассистентами (Claude, Copilot). Предоставляет доступ к ресурсам, логам и статусу сервисов, а также управляет сборкой и мониторингом. Идеально для разработчиков, автоматизирую...

Python⭐ 6
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин