Skip to main content

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:

  1. All 14 resources are listed in the Inspector.
  2. llmkms://guide/bootstrap returns the bootstrap guide.
  3. llmkms://manifest lists all resources with sha256 hashes and no errors.
  4. A new empty repo bootstrapped from the guide produces a clean lint result.
  5. scaffold_llm_kms and scaffold_mcp_server are 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)

Source distribution for llm-kms-mcp 0.1.1
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)

Table of built distributions (wheels) for llm-kms-mcp 0.1.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page