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.
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
uvx python-docs-mcp-server==0.4.1Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add io.github.ayhammouda-python-docs-mcp-server -- uvx python-docs-mcp-server==0.4.1รันในเทอร์มินัล
{ "mcpServers": { "io.github.ayhammouda-python-docs-mcp-server": { "command": "uvx", "args": [ "python-docs-mcp-server==0.4.1" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
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.
The canonical Python stdlib oracle for AI coding agents — always free, always MIT, token-frugal.
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.
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:
asyncio.TaskGroup should resolve to the actual symbol, not a fuzzy page hit3.12 and 3.13 do not always say the same thing)This server indexes the official docs locally and exposes a small set of MCP tools for lookup and section retrieval.
objects.invPrompt
What does
asyncio.TaskGroupdo in Python 3.13?
Typical flow
search_docs("asyncio.TaskGroup", kind="symbol", version="3.13")get_docs(...) using the slug and anchor returned by the best hitResult
The model gets the matching symbol and the relevant docs section, not a full-page dump.
Ask your MCP client:
In Python 3.13, how should I use
asyncio.TaskGroupand what changed from older asyncio patterns?
If setup is working, the client should use search_docs for the exact symbol,
then get_docs for the matching section. Instead of generic web results or an
entire docs page, it gets official stdlib text for the requested Python version,
trimmed to the section that matters.
Run directly with uvx:
uvx python-docs-mcp-server --version
Or install it once with pipx:
pipx install python-docs-mcp-server
If uv is installed but the uv command is not on your PATH, reopen your
shell or use python -m uv ... as a fallback for local contributor commands.
For kind="auto" with an explicit version, a nonempty search with spare result
slots may append one exact inventory target when the prompt contains one
known qualified identifier in that version. Original hits, snippets, scores,
order and notes are preserved. Full results, ambiguous identifiers, other kinds
and versionless queries are unchanged; the existing empty-result fallback is
unchanged. Canonical locations are deduplicated, including inventory aliases.
The append is admitted only when the complete proposed response serialized
by Pydantic's compact model_dump_json() is at most 8000 UTF-8 bytes. This is
not a global search cap: oversized original responses remain unchanged. It is
separate from get_docs(max_chars=8000), which limits content characters.
Build the local documentation index:
uvx python-docs-mcp-server build-index --versions 3.10,3.11,3.12,3.13,3.14
If you installed the package persistently, you can drop the uvx prefix:
python-docs-mcp-server build-index --versions 3.10,3.11,3.12,3.13,3.14
The first build downloads Python's objects.inv files, clones CPython docs
sources, runs sphinx-build -b json, and writes an SQLite index to your local
cache. It can take several minutes.
The source-pinned documentation targets include Python 3.10–3.15. To index 3.15 alongside 3.14, explicitly run:
uvx python-docs-mcp-server build-index --versions 3.14,3.15
A build replaces the local index with the requested versions; include every
version you want to keep. The first-run examples above intentionally remain
unchanged. The builder still marks the highest requested version as the
index default; adding this target does not select 3.15 in an existing index.
get_docs without a version uses the configured/detected default, while
versionless search spans indexed versions. Pass version="3.15" for isolated
3.15 answers. list_versions reports the actual index, not all build targets;
an unindexed explicit version raises an error, never an older-docs fallback.
This is documentation coverage, not a claim that the server runs on Python 3.15 or that a named MCP client was tested with it. Queries remain offline and read-only after a successful build. Until it is indexed, consult the official 3.15 docs directly.
The 3.15 target is CPython tag v3.15.0, commit
d220409a13b77de7a6c30abe16ea90db01528edc, with Sphinx 8.2.3.
See integration checks
for explicit-version and comparison examples.
This repository includes a project-scoped .mcp.json for clients that support
checked-in MCP server configuration. It points at the published package:
{
"mcpServers": {
"python-docs": {
"type": "stdio",
"command": "uvx",
"args": ["python-docs-mcp-server"]
}
}
}
Build the local documentation index with the first-run command above before expecting docs queries to return corpus-backed results.
Add this to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json
{
"mcpServers": {
"python-docs": {
"command": "uvx",
"args": ["python-docs-mcp-server"]
}
}
}
Restart Claude Desktop after editing the config file.
Add this to your Cursor MCP settings (.cursor/mcp.json in your project or
global settings):
{
"mcpServers": {
"python-docs": {
"command": "uvx",
"args": ["python-docs-mcp-server"]
}
}
}
Add this to .codex/config.toml:
[mcp_servers.python-docs]
command = "uvx"
args = ["python-docs-mcp-server"]
ruff, pyright, and pytest on macOS and Linux for Python 3.12
and 3.13.github/INTEGRATION-TEST.md, with MCP
Inspector for local checks and Claude/Cursor for real-client checksContributor commands and validation steps live in
CONTRIBUTING.md.
The server currently exposes seven MCP tools:
For search_docs with kind="auto" and an explicit indexed version, the
original lookup and full-text search run first. If both return no hits, the
server looks for dotted Python identifiers in the prompt. Exactly one distinct
identifier registered in that version enables a symbol-lookup fallback; repeated
mentions count once and unknown identifiers do not count. Multiple known
identifiers leave the result empty. A result note identifies fallback matches,
which are symbol documentation, not an answer to the complete prompt. Explicit
kinds, searches without a version, nonempty results, and result budgets are
unchanged.
Use this server when you want precise local Python docs retrieval rather than broad web search:
objects.invlookup_package_docsUse Context7 or a generic docs fetcher for third-party libraries, arbitrary web pages, or framework research. This server is not a universal docs search engine; it is a focused stdlib retrieval tool for AI coding agents.
get_docs responses are cached across MCP client/server restarts in the
platform cache directory:
<platform cache dir>/mcp-python-docs/retrieved-docs-cache.sqlite3
The cache stores completed get_docs results for the resolved Python docs
version plus request identity (slug, optional anchor, max_chars, and
start_index). Cache misses use the normal local index retrieval path and then
write the result.
Cache entries are also scoped to a fingerprint of the local index.db file
(path, size, and modification timestamp). If you rebuild or replace the local
docs index, older entries are ignored automatically. Deleting
retrieved-docs-cache.sqlite3 is safe; it removes cached retrieval results, not
the docs index.
lookup_package_docs queries the official PyPI JSON API documented at
https://docs.pypi.org/api/json/ (GET /pypi/<project>/json) and returns only
sources declared in that package's PyPI metadata: the PyPI project URL,
docs_url, home_page, and allowlisted project_urls labels such as
Documentation, Homepage, Source, and Repository.
The tool makes the trust boundary explicit with
trust_boundary="pypi-declared-metadata". It does not crawl pages, perform web
search, or silently fall back to unofficial community mirrors.
Check the local environment:
uvx python-docs-mcp-server doctor
This checks the runtime Python version, SQLite FTS5, cache/index paths, disk
space, and the venv/ensurepip support needed by build-index.
Validate an existing index:
uvx python-docs-mcp-server validate-corpus
If your Python build does not include SQLite FTS5:
Linux x86-64
Linux x86-64 users can install the optional bundled SQLite package:
pip install 'python-docs-mcp-server[pysqlite3]'
macOS / Windows / Linux ARM
Install Python from python.org or use:
uv python install
pythonX.Y-venv on Debian/UbuntuIf doctor says build venv support is unavailable, install the venv package
for the same Python minor version that runs the server:
sudo apt install python3.12-venv
Adjust 3.12 to match the version shown by doctor. Without this package,
build-index cannot create the disposable Sphinx environment it uses to build
JSON documentation content.
Earlier development snapshots of this project used the PyPI name
mcp-server-python-docs. The published PyPI project is
python-docs-mcp-server. If your MCP client config still references
the old name via uvx, you will see a Package not found error,
because uvx resolves projects by PyPI name.
Change your config args from:
"args": ["mcp-server-python-docs"]
to:
"args": ["python-docs-mcp-server"]
The wheel still installs a legacy mcp-server-python-docs console
script for users who already have the package installed and invoke
the binary by name on $PATH. That script is an alias and will be
removed in a future release.
uvx cache staleIf uvx python-docs-mcp-server runs an old version:
uvx --reinstall python-docs-mcp-server
Or clear the uv cache:
uv cache clean python-docs-mcp-server
The MSIX-packaged version of Claude Desktop on Windows may have restricted PATH
access. If uvx is not found, specify the full path in your config:
{
"mcpServers": {
"python-docs": {
"command": "C:\\Users\\YOU\\.local\\bin\\uvx.exe",
"args": ["python-docs-mcp-server"]
}
}
}
Replace YOU with your Windows username. Find the exact path with where uvx.
After running build-index, restart your MCP client so it picks up the new
database file. The server opens the index read-only on startup and does not
reload it while running.
On Windows, close the MCP client before rebuilding if the index file is locked.
For contributor setup and verification:
Tested on macOS and Linux. Windows should work, but it is not verified on every release.
The server requires Python 3.12+ to run. Source-pinned documentation targets cover Python 3.10 through 3.15; Python 3.15 is opt-in. The versions available for queries depend on the documentation versions selected when building the index.
MIT
The canonical Python stdlib oracle for AI coding agents — always free, always MIT, token-frugal.
{ "mcpServers": { "io.github.ayhammouda-python-docs-mcp-server": { "command": "uvx", "args": [ "python-docs-mcp-server==0.4.1" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Python Docs MCP Server ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-09 The canonical Python stdlib oracle for AI coding agents — always free, always MIT, token-frugal.