John Lancaster
1.3 KiB
icon
| icon |
|---|
| lucide/rocket |
Get started
What this MCP server is
An MCP server is a service that gives AI clients a stable way to discover and read capabilities through defined contracts. In practice, it exposes named resources and optional tools so clients can request context reliably instead of depending on ad-hoc prompts.
This server is designed to publish software methodology as canonical Markdown resources, with a small catalog for discovery, and to serve the same content as a static docs site. The intent is one source of truth for both humans and agents.
Quick start
Install dependencies first:
uv sync
Run the app locally with the static docs rebuilt first:
uv run zensical build && uv run uvicorn personal_mcp.main:app --host 127.0.0.1 --port 8765
Build and run the Docker image with the same exposed port:
docker build -t personal-mcp . && docker run --rm -p 8765:8765 personal-mcp
When the server is running, the health check is available at /healthz and the generated docs are available at /docs/.