Skip to main content
Glama

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

Возможности

Инструменты

Инструмент

Описание

list_docs(category?)

Список доступных файлов документации, опционально с фильтрацией по категории

read_doc(category, topic)

Чтение полного содержимого файла документации

search_docs(query, category?)

Полнотекстовый поиск по всей документации

Ресурсы

URI

Описание

docs://index

Полный индекс всех доступных файлов документации

docs://{category}/{topic}

Содержимое конкретного файла документации

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context
    10 npm
    265
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Transforms Markdown documentation into an intelligent knowledge base with AI-powered search and Q\&A through an MCP server.
    7 npm
    9
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that indexes documents and serves relevant context to LLMs via Retrieval Augmented Generation (RAG).
    28 npm
    36
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A documentation MCP server that crawls websites and Git repositories, stores them as Markdown, and provides tools to search and retrieve documentation for local LLMs and AI agents.
    Apache 2.0