MCP Documentation Server

Локальная база документов для агента: гибридный поиск по смыслу и словам и веб-интерфейс для просмотра и загрузки

343 ★ репозитория
Последний коммит 27 авг. 2026
MIT

andrea9293/mcp-documentation-serverАвтор:Andrea Bravaccino

Установка

Работает в: Claude Code
Cursor
Gemini CLI
OpenCode
Claude Desktop
SourceCraft
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mcp-documentation-server

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

Сервер читает и пишет файлы в своей папке данных и держит открытым локальный веб-порт
С ключом GEMINI_API_KEY тексты документов уходят в Gemini

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MCP Documentation Server хранит ваши документы на компьютере и дает агенту искать по ним. Документы добавляются инструментом add_document или кладутся в папку загрузок в форматах txt, md и pdf, после чего process_uploads режет их на фрагменты и считает векторы. Векторная база Orama и модель эмбеддингов Transformers.js работают локально, внешние базы и облачные API не нужны. Поиск гибридный: полнотекстовый и по близости векторов. Инструмент search_all_documents ищет сразу по всем документам, search_documents по одному, а get_context_window возвращает соседние фрагменты вокруг найденного, чтобы у модели был контекст пошире. Если задать GEMINI_API_KEY, появляется еще и search_documents_with_ai для разбора документов моделью Gemini. Рядом с MCP-сервером на порту 3080 запускается веб-интерфейс: список документов, загрузка перетаскиванием, поиск и просмотр фрагментов. Все инструменты доступны и как REST API, а в репозитории лежит скилл documentation-server, который учит агента вызывать эти запросы без загрузки схем MCP в контекст.

Для кого. Для разработчиков, которые хотят дать Claude Code, Cursor или Gemini CLI поиск по документации нового фреймворка, API или внутренним гайдам без облачных сервисов.

Подходит, если

Вы осваиваете новый фреймворк, и агенту нужна его документация, которой нет в обучающих данных модели
Внутренние гайды и спецификации лежат в md и pdf, и их нельзя отправлять во внешний облачный сервис
Нужен поиск, который находит и точное слово, и близкий по смыслу фрагмент
Хочется самому просматривать и пополнять базу знаний через браузер
Нужно сэкономить контекст: агент ходит в REST API, а схемы инструментов MCP не грузит

Не подходит, если

Документы лежат в docx, html или таблицах: сервер их не примет
Нужна общая база для команды на нескольких машинах: данные лежат в локальной папке
Нужен поиск по живым сайтам и репозиториям: сервер работает только с тем, что вы загрузили
Порт веб-интерфейса занят другим сервисом, а менять настройки не хочется

Пример запроса к агенту

Загрузи файлы из папки uploads в базу, найди в них раздел про аутентификацию и покажи соседние фрагменты

MCP

Транспорт: stdio
Авторизация: не нужна

Переменные окружения

GEMINI_API_KEY секрет: Ключ Gemini для инструмента search_documents_with_ai
MCP_BASE_DIR: Папка для хранения данных
MCP_EMBEDDING_MODEL: Имя модели эмбеддингов
START_WEB_UI: Запускать ли веб-интерфейс
WEB_PORT: Порт веб-интерфейса, по умолчанию 3080

Ограничения

Данные по умолчанию лежат в папке `~/.mcp-documentation-server`, путь меняется переменной MCP_BASE_DIR. Все переменные окружения необязательные.

Сервер рассчитан на один компьютер с локальной папкой данных: общего хранилища для команды в нем нет. Модель эмбеддингов по умолчанию Xenova/all-MiniLM-L6-v2, другую задает переменная MCP_EMBEDDING_MODEL. Скилл обращается к уже запущенному серверу, поэтому без Node.js и npx он бесполезен. Веб-интерфейс отключается переменной START_WEB_UI, порт меняет WEB_PORT.

Как отключить. Удалите блок documentation из конфигурации MCP-клиента и перезапустите клиент. Загруженные документы останутся в папке данных, ее можно стереть вручную.

Частые вопросы

Как поставить MCP Documentation Server в Claude Code?

Добавьте в конфигурацию MCP сервер, который запускается командой `npx -y @andrea9293/mcp-documentation-server`. После запуска веб-интерфейс откроется по адресу http://localhost:3080.

Нужен ли ключ Gemini?

Нет, поиск по документам работает локально на модели Xenova/all-MiniLM-L6-v2. Ключ GEMINI_API_KEY нужен только для инструмента search_documents_with_ai.

Какие форматы файлов принимает сервер?

txt, md и pdf. Файлы кладут в папку загрузок, путь к ней возвращает get_uploads_path, затем вызывают process_uploads.

Что дает скилл documentation-server?

Он описывает все REST-запросы сервера с примерами. Агент вызывает их через curl, и схемы инструментов MCP не занимают место в контексте.

Как поменять порт или папку с данными?

Через переменные окружения WEB_PORT и MCP_BASE_DIR в блоке env конфигурации. Веб-интерфейс отключается значением false в START_WEB_UI.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

xbsl-mcp-docs

Российский стек

MCP-сервер с полнотекстовым поиском по локальной документации 1С:Элемент, включая свои markdown и PDF

MCP-серверРасширенный доступ16

PageIndex MCP — длинные PDF для агента

PageIndex MCP

Официальный

MCP-сервер дает агенту читать длинные PDF по дереву структуры документа: поиск рассуждением вместо векторной базы

MCP-серверРасширенный доступ405

pdf-mcp

MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы

MCP-серверРасширенный доступ162

arxiv-mcp-server

Локальный MCP-сервер для работы с научной литературой arXiv: чтение статей по разделам, BibTeX из метаданных, отслеживание тем

MCP-серверРасширенный доступ3,2 тыс.

Семантический поиск по докам Jivo и SaluteBot

MCP Docs Hub

Российский стек

Коллекция MCP-серверов с FAISS-индексами для семантического поиска по документации Jivo, SaluteBot и SberSalute Code: поиск, чтение файлов и оглавление

MCP-серверРасширенный доступ

Docling MCP