ayhammouda/python-docs-mcp-server

ayhammouda/python-docs-mcp-server

от ayhammouda
MCP сервер для точного поиска по официальной документации Python stdlib. Работает офлайн, без API ключей. Индексирует docs.python.org по версиям, выдает символы и секции. Полезен AI-агентам на Python, экономит токены и контекст.

python-docs-mcp-server

For AI coding agents writing Python, python-docs-mcp-server is the canonical Python stdlib oracle: exact symbols, exact sections, exact versions — offline, always free, always MIT, token-frugal.

CI Security Audit CodeQL OpenSSF Scorecard python-docs-mcp-server MCP server MCP Registry License: MIT Python 3.12+ No API Keys Official Python Docs

Built for the moment your agent needs asyncio.TaskGroup signatures, pathlib.Path semantics, or what changed in 3.12 — not a web fetch, not a hosted API, not a vector store hallucinating section anchors. Just an indexed slice of docs.python.org, returned by symbol or by query, scoped to the version you actually ship on.

Why this exists

There is a difference between long context and usable context. Research like the Lost in the Middle study (Liu et al., 2023) found that models struggle to use relevant information buried in the middle of a long input. Pasting an entire documentation page into the model invites that failure. Returning the exact symbol, section, and version keeps the answer in a short, high-signal context instead.

Generic docs retrieval is a rough fit for Python stdlib questions:

Инструменты были проиндексированы:
compare_versionsтолько чтениеидемпотентный

Сравнивает символ стандартной библиотеки Python между двумя индексированными версиями. Возвращает change=added|removed|changed|unchanged с опциональными полями new_in, changed_in, deprecated_in, signature_delta (advisory), see_also_added/removed, section_diff и note. Обе версии должны быть индексированы; в противном случае понятная ошибка указывает доступные версии.

Параметры
  • symbolstringобязательный

    Полное имя символа Python, например 'asyncio.TaskGroup'

  • v1stringобязательный

    Строка версии Python, например '3.11'

  • v2stringобязательный

    Строка версии Python, например '3.11'

detect_python_versionтолько чтениеидемпотентный
Параметры

Без параметров.

get_docsтолько чтениеидемпотентный

Извлекает страницу документации или конкретный раздел. Укажите якорь для извлечения только раздела (намного дешевле). Пагинация через start_index.

Параметры
  • anchorstring | null

    Якорь раздела для извлечения только раздела.

  • max_charsinteger

    Максимум символов для возврата

  • slugstringобязательный

    Слаг страницы (например, 'library/asyncio-task.html')

  • start_indexinteger

    Начальная позиция для постраничной навигации

  • versionstring | null

    Версия Python (например, '3.13'). По умолчанию используется последняя.

list_versionsтолько чтениеидемпотентный

Выведи список версий документации Python, доступных в этом индексе.

Параметры

Без параметров.

lookup_package_docsтолько чтениеидемпотентныйвнешний мир

Находит объявленные пакетом URL документации, домашней страницы и исходного кода через официальные метаданные PyPI. Это не общий веб-поиск: он только запрашивает JSON API PyPI и возвращает официальные метаданные PyPI плюс объявленные пакетом URL проектов.

Параметры
  • packagestringобязательный

    PyPI package/project name

search_docsтолько чтениеидемпотентный

Ищет в документации Python. Использует kind='symbol' для поиска по API (asyncio.TaskGroup), kind='example' для примеров кода, kind='auto' в остальных случаях. Если версия не указана, ищет по всем версиям. Передаёт версию из поля version каждого результата в get_docs для согласованных результатов.

Параметры
  • kindenum

    Тип поиска. Используйте 'symbol' для поиска по API, 'example' для примеров кода, в остальных случаях 'auto'.

  • max_resultsinteger

    Максимальное количество результатов для возврата (1-100)

  • querystringобязательный

    Поисковый запрос: символ Python (asyncio.TaskGroup) или понятие (parse json)

  • versionstring | null

    Версия Python (например, '3.13'). По умолчанию используется последняя.

0.4.0основная
0.3.2
0.3.1
0.3.0
0.2.1
0.2.0
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2

Выберите клиент, чтобы установить ayhammouda/python-docs-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "ayhammouda-python-docs-mcp-server-kvwx32yjyx": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "python-docs-mcp-server"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "ayhammouda-python-docs-mcp-server-kvwx32yjyx": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "python-docs-mcp-server"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "ayhammouda-python-docs-mcp-server-kvwx32yjyx": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "python-docs-mcp-server"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"ayhammouda-python-docs-mcp-server-kvwx32yjyx\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"python-docs-mcp-server\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "ayhammouda-python-docs-mcp-server-kvwx32yjyx": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "python-docs-mcp-server"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add ayhammouda-python-docs-mcp-server-kvwx32yjyx -- uvx python-docs-mcp-server

Либо через JSON-конфиг:

claude mcp add-json ayhammouda-python-docs-mcp-server-kvwx32yjyx "{\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"python-docs-mcp-server\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add ayhammouda-python-docs-mcp-server-kvwx32yjyx -- uvx python-docs-mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.ayhammouda-python-docs-mcp-server-kvwx32yjyx]
command = "uvx"
args = ["python-docs-mcp-server"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите ayhammouda/python-docs-mcp-server, а в поле команды запуска — строку ниже:
uvx python-docs-mcp-server

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ayhammouda-python-docs-mcp-server-kvwx32yjyx": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "python-docs-mcp-server"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "ayhammouda-python-docs-mcp-server-kvwx32yjyx": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "python-docs-mcp-server"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например ayhammouda-python-docs-mcp-server-kvwx32yjyx.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: ayhammouda-python-docs-mcp-server-kvwx32yjyx
    command: uvx
    args:
      - "python-docs-mcp-server"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "ayhammouda-python-docs-mcp-server-kvwx32yjyx": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "python-docs-mcp-server"
      ]
    }
  }
}

Похожие MCP-сервера

mrjoshuak/godoc-mcp

mrjoshuak/godoc-mcp

от mrjoshuak

MCP-сервер для быстрого доступа к документации Go-пакетов. Он помогает LLM понимать код без чтения целых файлов, экономя токены. Полезен Go-разработчикам, использующим ИИ-ассистентов.

Go⭐ 125
Context7 MCP

Context7 MCP

официальный

от upstash

Находит свежую документацию и примеры кода для любых библиотек, подтягивает нужные фрагменты с учётом версии. Без выдуманных API из старых данных.

TypeScript⭐ 63337
dorukardahan/twitterapi-docs-mcp

dorukardahan/twitterapi-docs-mcp

от dorukardahan

MCP сервер для офлайн-доступа AI-ассистентов к документации TwitterAPI.io. Включает 67 эндпоинтов, 32 гайда и 24 статьи без API-ключа. Разработчикам, работающим с Twitter API, не нужно покидать редактор — всё под рукой.

JavaScript⭐ 10
ref-tools/ref-tools-mcp

ref-tools/ref-tools-mcp

от ref-tools

Ref ищет документацию по API, сервисам и библиотекам, отсеивает повторы и вместо целой страницы отдаёт только нужный фрагмент. Экономит контекст и деньги.

TypeScript⭐ 1183
laradji/deadzone

laradji/deadzone

от laradji

Deadzone — векторный индекс для семантического поиска по документации, работающий как локальный MCP-сервер. Полезен разработчикам AI-агентов, которым нужен поиск по документам без интернета. Исполь...

Go⭐ 4
yWorks/mcp-typescribe

yWorks/mcp-typescribe

от yworks

MCP-сервер для LLM-агентов: загружает TypeDoc JSON TypeScript API и предоставляет инструменты поиска символов, параметров и иерархии типов. Ускоряет разработку с новыми SDK и внутренними API без ретренинга моделей.

TypeScript⭐ 46
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин