PersonalKB — MCP Server

An MCP server that exposes a personal AI/ML research knowledge base (wiki) for use with any MCP-compatible client (Claude Desktop, Cursor, Kiro, etc.).

Tools

Tool	Description
`list_pages`	List all wiki pages, optionally filtered by category
`read_page`	Read a specific page by slug
`search_wiki`	Full-text search across all pages
`get_index`	Get the master index
`list_categories`	List categories with page counts

Setup

Requirements

Python 3.10+
pip install -r requirements.txt

MCP Client Configuration

Add to your MCP client config (e.g., Claude Desktop, Cursor, Kiro):

{
  "mcpServers": {
    "personal-knowledge-base": {
      "command": "python",
      "args": ["/path/to/app.py"],
      "env": {
        "PERSONAL_KB_PATH": "/path/to/Personal_Knowledge_Base"
      }
    }
  }
}

See mcp_config_example.json for a ready-to-use example.

Environment Variable

Variable	Default	Description
`PERSONAL_KB_PATH`	`/proj/lterbsdailytest/erajmuk/Personal_Knowledge_Base`	Path to the KB root directory

Wiki Structure

Personal_Knowledge_Base/
├── wiki/
│   ├── index.md          # Master index
│   ├── log.md            # Ingestion log
│   ├── sources/          # Source summaries
│   ├── concepts/         # Concept pages
│   ├── people/           # Person pages
│   ├── examples/         # Example/case study pages
│   └── comparisons/      # Comparison pages
└── raw/                  # Original source files (immutable)

License

MIT