John Lancaster
1.4 KiB
1.4 KiB
icon
| icon |
|---|
| lucide/rocket |
Personal MCP
This is a document library of software patterns, best practices, and structured references to external documentation, which are available in 2, equivalent ways. The same, exact markdown files are reused for both cases, so there is never any incongruity between them.
MCP Server
An MCP server at /mcp to provide context for AI systems. The markdown files are exposed as resources and are structured to be easily consumed by MCP clients, like VSCode.
Docs
A website at /docs for humans to read and review.
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/.