llm-kms MCP Handbook Server
An MCP Resource Server that ships the llm-kms schema, skill, and templates as a self-contained package. Any agent can read these resources to bootstrap its own llm-kms wiki in any repo — no external repo required.
What it exposes
| Resource URI | Content |
|---|---|
llmkms://guide/bootstrap |
Step-by-step bootstrap guide (start here) |
llmkms://spec/claude-md |
Full authoritative schema (CLAUDE.md) |
llmkms://skill/skill-md |
Thin router (SKILL.md) — points to the per-op skills below |
llmkms://skill/ingest |
Ingest procedure |
llmkms://skill/query |
Query procedure |
llmkms://skill/lint |
Lint procedure |
llmkms://skill/prune |
Prune procedure |
llmkms://template/atomic-note |
Blank atomic-note template |
llmkms://template/index |
Blank index.md starter |
llmkms://template/log |
Blank log.md starter |
llmkms://reference/gitignore |
Recommended .gitignore |
llmkms://reference/gitleaks |
Recommended .gitleaks.toml |
llmkms://reference/lint-script |
Standalone Python lint script |
llmkms://manifest |
JSON index with sha256 per resource |
All resources are bundled inside the package — no environment variables needed.
Tools
| Tool | Parameters | Does |
|---|---|---|
scaffold_llm_kms |
target_dir |
Scaffolds an llm-kms wiki folder structure (inbox/, raw/, archive/, system/templates/, index.md, log.md, merged .gitignore) in target_dir. Safe to re-run — skips files that already exist. |
scaffold_mcp_server |
target_dir, package_name, port=8765, concurrent_writes=False |
Generates a standalone wiki MCP server project in target_dir: core.py, server_public.py (HTTP, query-only), server_local.py (stdio, full tool set), a generated _config.py with a random bearer token, pyproject.toml, and a copy of the per-op skill files under .claude/skills/<package_name>/. concurrent_writes=True switches generated note IDs from 17 to 25 digits (collision-safe for multiple agents writing at once). |
Requirements
- Python >= 3.10
Install
From PyPI
pip install llm-kms-mcp
From source
git clone https://github.com/operator47/llm-kms-mcp.git
cd llm-kms-mcp
pip install .
Run (smoke test with MCP Inspector)
Node.js must be installed.
npx @modelcontextprotocol/inspector python -m llm_kms_mcp
In the Inspector: confirm all 14 resources appear under llmkms:// and both tools (scaffold_llm_kms, scaffold_mcp_server) are listed; read llmkms://guide/bootstrap to verify content.
Register with Claude Code
Project-scoped (.mcp.json in your repo):
{
"mcpServers": {
"llm-kms-handbook": {
"command": "python",
"args": ["-m", "llm_kms_mcp"]
}
}
}
With uv (no separate install step):
{
"mcpServers": {
"llm-kms-handbook": {
"command": "uvx",
"args": ["llm-kms-mcp"]
}
}
}
User-scoped via CLI:
claude mcp add llm-kms-handbook -- python -m llm_kms_mcp
Acceptance checks
After installing:
- All 14 resources are listed in the Inspector.
llmkms://guide/bootstrapreturns the bootstrap guide.llmkms://manifestlists all resources with sha256 hashes and no errors.- A new empty repo bootstrapped from the guide produces a clean lint result.
scaffold_llm_kmsandscaffold_mcp_serverare both callable and produce the files described above.
Metadata
Release files for llm-kms-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| llm_kms_mcp-0.1.1.tar.gz | 32.2 kB | Without provenance | Details for llm_kms_mcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| llm_kms_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for llm_kms_mcp-0.1.1-py3-none-any.whl |
Total release size: 68.1 kB
Release files / llm_kms_mcp-0.1.1.tar.gz
| Download URL | llm_kms_mcp-0.1.1.tar.gz |
|---|---|
| Size | 32.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
467ecf229e62436dbafceb8a7636bde29ea12cef2df5926e2e0471272757f652
|
|
BLAKE2b-256 checksum How to use checksums |
d9f777294b81071a70d27d26150474785b8f59b12a1f4a4cc693cc3d675bf2d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / llm_kms_mcp-0.1.1-py3-none-any.whl
| Download URL | llm_kms_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 35.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b490928c37642b80cd46db87057e29ef54460ba9e87a67d23edfc25875a04db8
|
|
BLAKE2b-256 checksum How to use checksums |
f94c6b78134d9c31cd943b4980134ccd921a764b1ff1cfc6d77816c662126bee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for llm-kms-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.