@jonmatum/knowledge-mcp

MCP server for jonmatum.com knowledge base. Search, browse, and query 150+ concepts, notes, experiments, and essays about software engineering, infrastructure, and AI.

Usage

With npx (no install)

Add to your MCP client config:

{
  "mcpServers": {
    "jonmatum-knowledge": {
      "command": "npx",
      "args": ["-y", "@jonmatum/knowledge-mcp"],
      "cwd": "/path/to/jonmatum.com"
    }
  }
}

cwd must point to the cloned jonmatum.com repo with generated/ data (run pnpm generate first).

Remote HTTP (no install, no clone)

If you don't want to run anything locally, use the hosted endpoint:

https://jonmatum.com/api/mcp

Any MCP client that supports Streamable HTTP transport can connect directly.

Tools

| Tool | Description | |------|-------------| | search_knowledge | Keyword search across titles, summaries, and tags | | get_concept | Get a single item by ID with full MDX body and related edges | | list_concepts | List items with optional type/status/tag filters | | get_graph | Get the knowledge graph or a subgraph around a node | | semantic_search | Similarity search using pre-computed 384-dim embeddings |

Prerequisites

The server reads from the repo's generated/ directory. Clone and generate:

git clone https://github.com/jonmatum/jonmatum.com
cd jonmatum.com
pnpm install
pnpm generate

License

MIT