Corpus Setup Guide

Setup Corpus MCP Server

Welcome! Because there is no committed corpus to fall back on, every developer builds their own corpus using their own GitHub PAT.

Prerequisites

1. Node.js: Ensure you are running Node.js 18 or higher.

   node -v
   

2. GitHub PAT: Create a Personal Access Token (classic) with repo and read:org scopes, or a fine-grained token with access to all organization repositories and metadata/content read access.

Configuration

Create a .env file in the root of the repository with the following variables:

GIT_ORG=your-github-org
GIT_PAT=your-github-personal-access-token
ENABLE_GAP_REPORTING=false
GITHUB_PROJECT=your-github-org/doc-gaps-repo # Required only if ENABLE_GAP_REPORTING is true

Setup and Build

1. Install dependencies:

   npm ci
   

2. Start the server (this will automatically fetch and build the corpus and system map):

   npm start
   

   Alternatively, you can manually run the build pipeline before starting:

   npm run build:corpus
   npm run build:map
   npm run build
   

Registering with Antigravity

Antigravity natively supports MCP. You can configure this server globally by adding it to ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "corpus": {
      "command": "node",
      "args": ["/absolute/path/to/code-context-mcp/dist/src/index.js"],
      "env": {
        "GIT_ORG": "your-github-org",
        "DOTENV_CONFIG_PATH": "/absolute/path/to/code-context-mcp/.env",
        "CORPUS_DIR": "/absolute/path/to/code-context-mcp/corpus"
      }
    }
  }
}

Registering with Claude

To use Corpus with Claude Desktop or Claude Code, add it to your configuration.

Claude Desktop

Edit your claude_desktop_config.json:

{
  "mcpServers": {
    "corpus": {
      "command": "node",
      "args": ["/absolute/path/to/code-context-mcp/dist/src/index.js"],
      "env": {
        "GIT_ORG": "your-github-org",
        "GIT_PAT": "your-github-pat",
        "CORPUS_DIR": "/absolute/path/to/code-context-mcp/corpus"
      }
    }
  }
}