Repository navigation
docs: generated tool table, credential scope, NPM compatibility - #34
Merged
Merged
Conversation
- Let's Encrypt requests no longer send meta.letsencrypt_email /
letsencrypt_agree on NPM >= 2.13, whose schema rejects them
(additionalProperties: false). Version comes from GET /api/, cached.
email becomes optional; still required on NPM < 2.13.
- get_access_list passes ?expand=items,clients (NPM omits rules
otherwise) and drops NPM's password "hint" (first char + length).
- update_proxy_host / update_redirection_host accept 0 for
certificate_id / access_list_id to detach.
- Extract message from NPM's {"error": {"code", "message"}} bodies.
- Wrap httpx transport errors in NPMConnectionError naming NPM_URL.
- Support Python 3.10+; CI tests 3.10-3.13, lint as separate job.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BQNvypim823UvUJXvw9amj
- create_letsencrypt_cert takes dns_provider, dns_provider_credentials and propagation_seconds (NPM certificate meta fields). dns_challenge without provider+credentials, DNS fields without dns_challenge, and wildcard domains over HTTP-01 are rejected before any request. Dry-run previews redact dns_provider_credentials. - get_certificate and delete_certificate (NPM revokes Let's Encrypt certs on delete; docstring says to detach hosts first). - MCP end-to-end tests: FastMCP in-memory client -> real NPMClient -> respx-mocked NPM. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BQNvypim823UvUJXvw9amj
- README tool table generated from registered tools by docs/tools_table.py; tests/test_readme.py fails on drift. - Fix `claude mcp add` for SSE: needs --transport sse, otherwise the URL is run as a stdio command. Add bearer-header variant. - uvx-based Claude Desktop and Claude Code stdio configs. - Security: NPM credential scope (dedicated non-admin user, per-resource manage/view/hidden permissions), JWT/credential handling notes. - NPM compatibility section (2.12 vs 2.13+ certificate schema). - Limitations refreshed; 34 tools; contributing step points at register_all(); ignore build/. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BQNvypim823UvUJXvw9amj
euisuh
commented
Oct 29, 2026
euisuh
left a comment
Owner
Author
There was a problem hiding this comment.
Gates: ruff, pytest (233 passed) pass locally; private-repo CI is billing-blocked, not a test result.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Stacked on #33, which is stacked on #32. Merge in order #32 → #33 → this PR. The diff against
masterincludes their commits until they merge. This PR's own commit only touches docs,docs/tools_table.py,tests/test_readme.py, and.gitignore.python docs/tools_table.pyprints name, category, read-only flag, and the first sentence of each registered tool's description.tests/test_readme.pyfails if the README block between<!-- tools:start -->and<!-- tools:end -->differs.claude mcp add npm http://localhost:8000/sse(README andexamples/claude-code.md) registers a stdio server whose command is the URL, becauseclaude mcp adddefaults to--transport stdio(checked withclaude mcp add --help). It's now--transport sse, with an-H "Authorization: Bearer …"variant./api/tokens,/api/nginx/*, andGET /api/. The section recommends a dedicated user with per-resourcemanage/view/hiddenpermissions (NPMpermission-object.json), and aview-only user plusNPM_READ_ONLYfor inspect-only setups. It also covers JWT handling, DNS-credential exposure, and the stripped access-listhint.SECURITY.mdno longer says "dedicated NPM admin account".emailis optional.Usage I ran
Stdio launch through uvx from this checkout, with NPM unreachable on purpose (
NPM_URL=http://127.0.0.1:9), via a FastMCP stdio client:Test evidence
Not done
docs/demo.gifstill shows the pre-2.13 payload. Re-recording needs VHS:vhs docs/demo.tape.🤖 Generated with Claude Code
https://claude.ai/code/session_01BQNvypim823UvUJXvw9amj