# Python Docs MCP Server

Локально ищет сигнатуры и разделы стандартной библиотеки Python по точным версиям. Спасает контекст ИИ-агента от лишних веб-страниц.

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

## Что делает

Сервер держит под рукой локальную базу документации CPython, упакованную в SQLite с полнотекстовым поиском FTS5. Вместо загрузки тяжелых страниц он отдаёт модели конкретный символ или нужный подраздел руководства. Для работы клиенту доступны семь инструментов только для чтения, включая поиск по `objects.inv` и постраничную выдачу текста.

Поведение привязано к выбранному релизу языка от 3.10 до 3.15. Если агент запрашивает синтаксис `asyncio.TaskGroup` для версии 3.13, сервер находит именно его свойства без перехода к старым практикам. Объём выдачи при поиске ограничен восемью тысячами байт UTF-8, а чтение разделов через `get_docs` отсекается лимитом в 8000 символов.

Для запуска требуется Python 3.12 или выше. Без предварительной сборки базы через команду `build-index` сервер работать не сможет. Первый запуск требует клонирования исходников документации CPython и занимает несколько минут.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

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

**Командой платформы**
```bash
claude mcp add python-docs-mcp-server -- uvx python-docs-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from python-docs-mcp-server <команда>

### Codex

**Командой платформы**
```bash
codex mcp add python-docs-mcp-server -- uvx python-docs-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from python-docs-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "python-docs-mcp-server": {
            "command": "uvx",
            "args": [
                "python-docs-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from python-docs-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "python-docs-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "python-docs-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from python-docs-mcp-server <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add python-docs-mcp-server uvx python-docs-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from python-docs-mcp-server <команда>

## Когда брать
- найти точную сигнатуру функции стандартной библиотеки для конкретной версии Python
- проверить изменения в модуле `asyncio` между разными релизами языка
- сократить расход контекстного окна ИИ за счёт точечной выгрузки подразделов
- обращаться к официальной документации Python без подключения к сети

## Примеры запросов агенту
- Покажи параметры `asyncio.TaskGroup` в Python 3.13 через `python-docs-mcp-server`.
- Найди в документации Python 3.12 методы работы с путями в `pathlib.Path`.
- Какие изменения появились в стандартной библиотеке Python 3.14 по сравнению с 3.13?

## Похожие
- [Serena MCP: the IDE for your agent](https://affpapa.org/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP-сервер · ★ 30677
- [Compiler Explorer](https://affpapa.org/nevibecode/mcp/compiler-explorer.md) — MCP-сервер · ★ 19148
- [Claude Code Explorer MCP](https://affpapa.org/nevibecode/mcp/claude-code-explorer-mcp.md) — MCP-сервер · ★ 6235
- [Tolgee](https://affpapa.org/nevibecode/mcp/tolgee.md) — MCP-сервер · ★ 4139
- [jshookmcp](https://affpapa.org/nevibecode/mcp/jshookmcp.md) — MCP-сервер · ★ 2061
- [pyscn](https://affpapa.org/nevibecode/mcp/pyscn.md) — MCP-сервер · ★ 1096

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