# md-log-mcp

MCP-сервер, который сохраняет отчёты агента в markdown прямо в md-log: по пути, с версиями и картинками.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3
- Автор: md-log
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/md-log/md-log-mcp
- Обновлён: 2026-10-04
- HTML: https://affpapa.org/nevibecode/mcp/md-log-mcp

## Что делает

Агент пишет отчёт по пути вроде `my-project/2026-07-07-error-report.md`, а сервер отправляет его в hosted-сервис md-log. Папок может не быть — они создадутся сами. Каждое сохранение становится новой неизменяемой версией, так что историю правок видно целиком.

Внутри 17 инструментов. Главный — `save_markdown`: создаёт или перезаписывает файл, при необходимости сначала загружает вложенные картинки и подменяет плейсхолдеры на ссылки `asset://`. Есть `edit_markdown` для точечной замены фрагментов и `append_to_markdown` для дописывания в конец. Оба работают через оптимистичную блокировку по `base_version_no` и один раз повторяют попытку при конфликте.

Нужен Node 22+ и Personal Access Token из веб-приложения md-log (раздел настроек с токенами, показывается один раз). Без токена сервер к бэкенду не подключится. Подключение возможно двумя способами: удалённый HTTP-эндпоинт `https://mcp.md-log.com/mcp` или локальный stdio через `npx -y md-log-mcp`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `MDLOG_API_BASE_URL`, `MDLOG_PAT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add md-log-mcp -e MDLOG_API_BASE_URL=<MDLOG_API_BASE_URL> -e MDLOG_PAT=<MDLOG_PAT> -- npx -y md-log-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add md-log-mcp --env MDLOG_API_BASE_URL=<MDLOG_API_BASE_URL> --env MDLOG_PAT=<MDLOG_PAT> -- npx -y md-log-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "md-log-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "md-log-mcp"
            ],
            "env": {
                "MDLOG_API_BASE_URL": "<MDLOG_API_BASE_URL>",
                "MDLOG_PAT": "<MDLOG_PAT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "md-log-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "md-log-mcp"
            ],
            "env": {
                "MDLOG_API_BASE_URL": "<MDLOG_API_BASE_URL>",
                "MDLOG_PAT": "<MDLOG_PAT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MDLOG_API_BASE_URL=<MDLOG_API_BASE_URL> -e MDLOG_PAT=<MDLOG_PAT> md-log-mcp npx -y md-log-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- сохранить отчёт агента в markdown по заданному пути
- загрузить скриншоты вместе с текстом и получить ссылки `asset://`
- дописать новый раздел в существующий отчёт без перезаписи всего файла
- заменить конкретный фрагмент текста, не трогая остальное
- откатить файл к более ранней версии из истории

## Примеры запросов агенту
- Сохрани отчёт об ошибке в `my-project/2026-07-07-error-report.md`
- Допиши в конец отчёта раздел с выводами
- Замени в отчёте строку с версией на актуальную

## Похожие
- [report-generator](https://affpapa.org/nevibecode/agents/report-generator.md) — субагент · 1930 установок
- [quarto-authoring](https://affpapa.org/nevibecode/skills/quarto-authoring.md) — скилл · 1400 установок
- [scouting-report-builder](https://affpapa.org/nevibecode/skills/scouting-report-builder.md) — скилл · 309 установок
- [answer-me-with-html](https://affpapa.org/nevibecode/skills/answer-me-with-html.md) — скилл · 5400 установок
- [deep-research](https://affpapa.org/nevibecode/skills/199-biotechnologies-deep-research.md) — скилл · 10200 установок
- [adrkit decision memory](https://affpapa.org/nevibecode/mcp/adrkit-decision-memory.md) — MCP-сервер · ★ 21

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md