# go-docs-mcp

MCP-сервер go-docs-mcp для Claude Code открывает ассистенту доступ к чтению документов 14 форматов и распознаванию сканов. Запускается при поиске по файлам каталога или вызове ресурсов через docs://.

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

## Что делает

Сервер читает файлы из каталога переменной `DOCS_MCP_DIR` и возвращает их текст, структуру заголовков или таблицы по протоколу MCP. Для текстовых вызовов действуют параметры `offset` и `max_chars`, поэтому объёмные документы не забивают окно контекста модели. Каждый документ дополнительно доступен как ресурс `docs://<filename>`.

Для работы с обычными `TXT`, `MD` и `CSV` сторонний софт не требуется. Чтобы открывать `PDF`, системе нужен пакет `poppler`. Для офисных таблиц, презентаций, файлов `DOCX`, `EPUB` и ноутбуков `IPYNB` понадобится `pandoc`, а чтение картинок и сканированных страниц опирается на `tesseract`.

Готовый контейнер Docker уже содержит poppler, pandoc и tesseract с английским и испанским словарями. Без внешних утилит в хост-системе бинарник ограничится базовыми текстовыми форматами.

## Требования
- Нужно: Docker
- Переменные окружения: `DOCS_MCP_DIR`, `DOCS_MCP_OCR_LANG`, `DOCS_MCP_DISABLE_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env DOCS_MCP_DIR=<DOCS_MCP_DIR> --env DOCS_MCP_OCR_LANG=<DOCS_MCP_OCR_LANG> --env DOCS_MCP_DISABLE_URL=<DOCS_MCP_DISABLE_URL> --transport stdio go-docs-mcp -- docker run -i --rm -e DOCS_MCP_DIR -e DOCS_MCP_OCR_LANG -e DOCS_MCP_DISABLE_URL ghcr.io/drolosoft/go-docs-mcp:1.5.0
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add go-docs-mcp --env DOCS_MCP_DIR=<DOCS_MCP_DIR> --env DOCS_MCP_OCR_LANG=<DOCS_MCP_OCR_LANG> --env DOCS_MCP_DISABLE_URL=<DOCS_MCP_DISABLE_URL> -- docker run -i --rm -e DOCS_MCP_DIR -e DOCS_MCP_OCR_LANG -e DOCS_MCP_DISABLE_URL ghcr.io/drolosoft/go-docs-mcp:1.5.0
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "go-docs-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "DOCS_MCP_DIR",
                "-e",
                "DOCS_MCP_OCR_LANG",
                "-e",
                "DOCS_MCP_DISABLE_URL",
                "ghcr.io/drolosoft/go-docs-mcp:1.5.0"
            ],
            "env": {
                "DOCS_MCP_DIR": "<DOCS_MCP_DIR>",
                "DOCS_MCP_OCR_LANG": "<DOCS_MCP_OCR_LANG>",
                "DOCS_MCP_DISABLE_URL": "<DOCS_MCP_DISABLE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "go-docs-mcp": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "DOCS_MCP_DIR",
                "-e",
                "DOCS_MCP_OCR_LANG",
                "-e",
                "DOCS_MCP_DISABLE_URL",
                "ghcr.io/drolosoft/go-docs-mcp:1.5.0"
            ],
            "env": {
                "DOCS_MCP_DIR": "<DOCS_MCP_DIR>",
                "DOCS_MCP_OCR_LANG": "<DOCS_MCP_OCR_LANG>",
                "DOCS_MCP_DISABLE_URL": "<DOCS_MCP_DISABLE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e DOCS_MCP_DIR=<DOCS_MCP_DIR> -e DOCS_MCP_OCR_LANG=<DOCS_MCP_OCR_LANG> -e DOCS_MCP_DISABLE_URL=<DOCS_MCP_DISABLE_URL> go-docs-mcp docker run -i --rm -e DOCS_MCP_DIR -e DOCS_MCP_OCR_LANG -e DOCS_MCP_DISABLE_URL ghcr.io/drolosoft/go-docs-mcp:1.5.0
```
Вместо <…> подставьте свои значения

## Когда брать
- извлечь текст и таблицы из офисных файлов `DOCX` и `XLSX`
- распознать текст со сканов и картинок через OCR
- прочитать конкретный диапазон страниц объёмного PDF
- найти фрагмент в каталоге документов через полнотекстовый поиск

## Примеры запросов агенту
- Найди в папке документов отчёт за третий квартал и покажи таблицу расходов
- Прочитай текст со скана `invoice.png` через OCR
- Выдели структуру разделов из файла `spec.docx` и конвертируй его в Markdown

## Похожие
- [pdf-processing-pro](https://affpapa.org/nevibecode/skills/pdf-processing-pro.md) — скилл · 5869 установок
- [liteparse](https://affpapa.org/nevibecode/skills/k-dense-ai-liteparse.md) — скилл · 1700 установок
- [pdf-to-structured](https://affpapa.org/nevibecode/skills/pdf-to-structured.md) — скилл · 149 установок
- [pdf](https://affpapa.org/nevibecode/skills/shareai-lab-pdf.md) — скилл · ★ 80707 у репозитория
- [whitepaper](https://affpapa.org/nevibecode/skills/whitepaper.md) — скилл · 1600 установок

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