# 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:

```bash
npm install -g @klouwer94/ast-indexer
```

The published package now includes the required Tree-sitter runtime and grammars as regular runtime dependencies, so AST tools work in normal global and `npx` installs without extra manual setup on the supported Node.js majors above.

Node.js 25 is not currently supported for the published package because upstream `tree-sitter` does not ship a compatible native build there. The repository itself may still work in some local pnpm setups because it applies a development patch during install, but that patch is not present in a normal consumer npm install.
AST-Indexer currently supports Node.js 20, 22, and 24 for published-package usage.

Add it to your MCP client configuration:

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

For `npx` usage and HTTP transport configuration, see [docs/usage.md](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 for definitions (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.
- Inspect JavaScript, TypeScript, TSX, C#, and SQL syntax trees with Tree-sitter tools such as `get_ast`, `get_ast_node_at_position`, and `structural_search`.
- Find syntactic call sites such as C# FluentAssertions chains like `.Should()` via `structural_search` instead of definition-only symbol 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](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](docs/project-architecture.md).

## Contributors

[![Contributors](https://img.shields.io/github/contributors/jaccoklouwer/ast-indexer)](https://github.com/jaccoklouwer/ast-indexer/graphs/contributors)

Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for local setup and contribution guidelines.

## License

ISC