Skip to content

Commit 737aa7b

Browse files
ayhammoudaclaude
andcommitted
docs: address CodeRabbit review feedback (3 findings)
- README.md: wrap the Windows MSIX Claude Desktop config in PRE-PYPI markers so pre-PyPI readers get the --from git+... form alongside the post-PyPI survivor (mirrors the lines 157-188 pattern). - docs/launch/show-hn.md: add a concrete "Demo query" line to both the pre-PyPI feedback draft and the post-PyPI Show HN draft, using asyncio.TaskGroup on Python 3.13 as the example. - docs/launch/reddit-posts.md: add an r/ClaudeAI launch variant alongside r/Python and r/LocalLLaMA, leaning on the Claude Desktop / Claude Code MCP integration angle as the audience-specific hook. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 7b0c652 commit 737aa7b

3 files changed

Lines changed: 63 additions & 0 deletions

File tree

README.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -439,6 +439,25 @@ uv cache clean python-docs-mcp-server
439439
The MSIX-packaged version of Claude Desktop on Windows may have restricted PATH
440440
access. If `uvx` is not found, specify the full path in your config:
441441

442+
<!-- PRE-PYPI: remove the GitHub-source config and the "After PyPI publishing, use:" lead-in after the first PyPI publish; the post-PyPI config fence below survives -->
443+
```json
444+
{
445+
"mcpServers": {
446+
"python-docs": {
447+
"command": "C:\\Users\\YOU\\.local\\bin\\uvx.exe",
448+
"args": [
449+
"--from",
450+
"git+https://github.com/ayhammouda/python-docs-mcp-server.git",
451+
"python-docs-mcp-server"
452+
]
453+
}
454+
}
455+
}
456+
```
457+
458+
After PyPI publishing, use:
459+
<!-- /PRE-PYPI -->
460+
442461
```json
443462
{
444463
"mcpServers": {

docs/launch/reddit-posts.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,3 +72,39 @@ uvx --from git+https://github.com/ayhammouda/python-docs-mcp-server.git python-d
7272

7373
I'd appreciate practical feedback from people wiring MCP into local coding
7474
workflows.
75+
76+
## r/ClaudeAI
77+
78+
> Reminder: do not post until the package is published on PyPI and the release
79+
> smoke test passes (see top-of-file gate).
80+
81+
Title: Local MCP server that gives Claude precise Python stdlib docs
82+
83+
I built `python-docs-mcp-server`, a small read-only MCP server that drops into
84+
Claude Desktop or Claude Code and gives Claude exact access to the official
85+
Python standard library documentation.
86+
87+
It runs on Python 3.12+ and indexes docs for Python 3.10 through 3.14.
88+
89+
Why I built it:
90+
91+
- Claude is strong on Python but answers can drift between stdlib versions
92+
- generic docs MCP servers pull in noise from broad web sources
93+
- I wanted Claude to retrieve one official stdlib section, not a whole page
94+
- the MCP tools are read-only, so the operational story is boring
95+
96+
How I use it: I ask Claude things like "in Python 3.13, what does
97+
`asyncio.TaskGroup` change vs older asyncio patterns?" and it retrieves the
98+
exact section from the official 3.13 docs instead of guessing from generic
99+
web results.
100+
101+
Repo: https://github.com/ayhammouda/python-docs-mcp-server
102+
103+
PyPI publishing is still being finalized. For now, test from source:
104+
105+
```bash
106+
uvx --from git+https://github.com/ayhammouda/python-docs-mcp-server.git python-docs-mcp-server --version
107+
```
108+
109+
Feedback welcome on Claude Desktop / Claude Code MCP config, retrieval
110+
quality, and which stdlib lookups feel clunky in real use.

docs/launch/show-hn.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,10 @@ What it does:
2828
- supports version-aware lookup across Python 3.10 through 3.14
2929
- runs locally, read-only, with no API keys
3030

31+
Demo query:
32+
33+
- "In Python 3.13, what does `asyncio.TaskGroup` change compared to older asyncio patterns?"
34+
3135
It is intentionally narrow. Use Context7 or generic retrieval for broad
3236
third-party docs and web research. Use this when you want official stdlib docs
3337
with less token waste.
@@ -68,6 +72,10 @@ What it does:
6872
- supports version-aware lookup across Python 3.10 through 3.14
6973
- runs locally, read-only, with no API keys
7074

75+
Demo query:
76+
77+
- "In Python 3.13, what does `asyncio.TaskGroup` change compared to older asyncio patterns?"
78+
7179
Repo: https://github.com/ayhammouda/python-docs-mcp-server
7280

7381
First run after the PyPI release:

0 commit comments

Comments
 (0)