Personal MCP¶

Personal MCP is a library of software development guidance for people and AI assistants. Content is written once in Markdown and published as both a documentation website and an MCP server.

What It Provides¶

• Skills provide focused guidance for development tasks.
• Prompts provide reusable workflows with named inputs.
• Documentation makes the same material easy to browse and maintain.

The HTTP service exposes the MCP endpoint at /mcp and the website at /docs/.

Quick Start¶

Install dependencies, build the website, and start the server:

uv sync
uv run zensical build
uv run personal-mcp --host 127.0.0.1 --port 8765

Then open http://127.0.0.1:8765/docs/ or connect an MCP client to http://127.0.0.1:8765/mcp.

The MCP server can also run over standard input and output:

uv run mcp-stdio

For Docker:

docker compose up --build

Read Next¶

• Using Personal MCP
• Authoring Guide
• Architecture
• Running the Server
• Testing
• Security
• Content Contracts