AST-Indexer MCP Server

AST-Indexer is a Model Context Protocol (MCP) server for indexing Git repositories with AST parsing. It extracts functions, classes, imports, variables, and SQL schema objects from JavaScript, TypeScript, C#, and SQL codebases so they can be queried through MCP tools.

Installation

Install the server globally:

npm install -g @klouwer94/ast-indexer

AST-Indexer requires Node.js 20 or newer.

Add it to your MCP client configuration:

{
  "mcpServers": {
    "ast-indexer": {
      "command": "ast-indexer"
    }
  }
}

For npx usage and HTTP transport configuration, see docs/usage.md.

Features

• Index Git repositories with include and exclude glob patterns.
• Parse JavaScript and TypeScript, including .js, .jsx, .mjs, .cjs, .ts, .tsx, .mts, and .cts.
• Parse C# using regex-based extraction (classes, methods, properties, using directives, UTF-16 encoding support).
• Parse SQL using regex-based extraction (tables, views, stored procedures, functions, triggers, and indexes).
• Search indexed repositories for functions, classes, imports, SQL tables, SQL views, SQL triggers, and SQL indexes.
• Return repository-level statistics for indexed files and extracted symbols.
• Two-layer cache: per-file memory cache backed by a disk cache keyed on Git commit hash or file mtime.
• Supports both stdio (default) and HTTP (--transport http) transport modes.
• Built with TypeScript, Zod, and Vitest.

Using the MCP server

See docs/usage.md for the full tool reference, CLI flags, configuration examples, and glob pattern behavior.

If you want to understand how the codebase is structured, see docs/project-architecture.md.

Contributors

Contributions are welcome. See CONTRIBUTING.md for local setup and contribution guidelines.

License

ISC