mcp-docs

Универсальный MCP-сервер, который предоставляет LLM доступ к документации в формате Markdown, позволяя им искать информацию и отвечать на вопросы по любой программной документации.

Идентификация сервера (имя, инструкции, метки категорий) полностью определяется директорией docs/, которая является отдельным репозиторием, клонированным рядом с этим.

Требования

• Python 3.14+

• uv

Related MCP server: repocks

Установка

1. Клонирование репозитория с документацией

Директория docs/ должна существовать до запуска сервера. Клонируйте в нее репозиторий с документацией:

git clone <docs-repo-url> docs

2. Установка зависимостей

uv sync

Структура директории docs/

Сервер автоматически обнаруживает категории из поддиректорий. Единственный обязательный файл — config.toml в корне docs/.

docs/
├── config.toml          # required — project identity
├── <category>/
│   ├── <topic>.md
│   └── ...
└── <category>/
    └── ...

config.toml

[project]
name = "my-project"
instructions = """
System instructions for the LLM. Describe what this documentation covers
and how the model should use the available tools.
"""

[categories]
folder-name = "Human-readable label"

• [project] является обязательным. name идентифицирует сервер; instructions направляет LLM.

• [categories] является необязательным. Любая поддиректория, не указанная здесь, автоматически получает метку в формате Title Case (my-folder → My Folder).

• Файлы внутри поддиректорий img/ никогда не передаются.

Использование

Запуск сервера (режим stdio)

uv run main.py

Разработка с помощью MCP Inspector

uv run mcp dev main.py

Открывает MCP Inspector в браузере. Чтобы подключиться к запущенному SSE или Streamable HTTP-серверу, сначала запустите его и укажите инспектору выведенный адрес конечной точки:

uv run main.py --transport sse
uv run main.py --transport streamable-http

Настройка для Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "my-project": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-docs", "run", "main.py"]
    }
  }
}

Настройка для Claude Code

claude mcp add my-project -- uv --directory /path/to/mcp-docs run main.py

Возможности

Инструменты

Ресурсы