# ExpertPack MCP

> ExpertPack MCP is an MCP server for knowledge and memory. Serve ExpertPack knowledge packs with hybrid search and traceable sources. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Website:** https://expertpack.ai
- **Repository:** https://github.com/brianhearn/ep-mcp
- **MCP Registry name:** io.github.brianhearn/ep-mcp
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

ep-mcp turns an ExpertPack, a Markdown-based pack of expert knowledge, into a queryable service for MCP clients. It targets knowledge that frontier models tend to lack, such as support lore and product gotchas, organised as one concept per file.

Retrieval blends BM25 with vector search, adds metadata boosting, MMR re-ranking and optional graph traversal, and expands declared requirements automatically. If the embedding provider fails it falls back to lexical search. Results carry IDs, content hashes, verification dates and source files, and an optional reconstruct mode returns line ranges and original text so answers can be proven.

It installs from PyPI and uses a Gemini or Azure OpenAI key for embeddings. The README reports a 97.6 percent hit rate on a 22-question benchmark.

## Features

- **Hybrid search:** Combines BM25 and vector search.
- **Provenance:** Results include hashes and verification dates.
- **Reconstruct mode:** Returns source spans and line ranges.
- **Graph expansion:** Optional multi-hop traversal.
- **Freshness flags:** Marks stale or expired content.
- **Lexical fallback:** Keeps working if embeddings fail.

## Good for

- Give an agent product expertise
- Ground answers with citations
- Serve a person or process knowledge pack
- Measure retrieval quality

## Install

### Claude Code (Terminal)

```sh
claude mcp add ep-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env AZURE_OPENAI_API_KEY='<AZURE_OPENAI_API_KEY>' -- uvx ep-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ep-mcp": {
      "command": "uvx",
      "args": [
        "ep-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ep-mcp": {
      "command": "uvx",
      "args": [
        "ep-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ep-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ep-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ep-mcp": {
      "command": "uvx",
      "args": [
        "ep-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ep-mcp": {
      "command": "uvx",
      "args": [
        "ep-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>"
      }
    }
  }
}
```

## Tools

- `ep_read`: Reads a file or section from a pack, optionally with neighbouring sections.

## FAQ

### What does it need?

A Gemini or Azure OpenAI key for embeddings.

### What if embeddings are down?

It falls back to lexical search.

### Which clients work?

Claude Desktop, Cursor, Windsurf, Claude.ai and custom hosts.

### What are pack types?

Person, product and process packs.

### How do I add ExpertPack MCP to Claude Code?

Run this command in your terminal: claude mcp add ep-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env AZURE_OPENAI_API_KEY='<AZURE_OPENAI_API_KEY>' -- uvx ep-mcp

### What are the best alternatives to ExpertPack MCP?

The closest alternatives to ExpertPack MCP are Codebase Memory, XERJ, headroom, omniget and next-ai-draw-io.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [headroom](https://ai-powered.com/mcp/headroom-3): headroom is an open-source MCP server for ai models and llm tooling.
- [omniget](https://ai-powered.com/mcp/omniget): omniget is an open-source MCP server for ai models and llm tooling.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [unity-mcp](https://ai-powered.com/mcp/unity-mcp-2): unity-mcp is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/expertpack-mcp
