Open Repo MCP

Index your codebase and expose it to AI agents via the Model Context Protocol.

Open source notice

This project is part of the Open Collective project Simply Hexagonal and is open to updates by its users, we ensure that PRs are relevant to the community. In other words, if you find a bug or want a new feature, please help us by becoming one of the contributors ✌️ ! See the contributing section.

Like this module? ❤

Please consider:

• Buying me a coffee ☕
• Supporting me on Patreon 🏆
• Starring this repo on Github 🌟

AI and Compliance Notice

The ⛩️ OpenKai quality framework for AI-assisted production was used in the creation of this project, making it ISO 42001 compliant by ensuring human oversight and governance.

30% Human · 70% AI · 100% epic

Quick Start

# Install (with VS Code MCP configuration)
npx open-repo-mcp init --vscode

# Start the server
npx open-repo-mcp start

# Index your repository
npx open-repo-mcp index

Or with Bun:

bunx open-repo-mcp init --vscode
bunx open-repo-mcp start
bunx open-repo-mcp index

What It Does

open-repo-mcp parses your codebase using Tree-sitter AST parsing, extracts symbols (functions, classes, types, interfaces, etc.), optionally generates AI-powered summaries, and serves everything through an MCP server that AI tools can query.

Supported languages:

• TypeScript
• JavaScript
• TSX
• Python
• Go
• Rust

Planned additional language support:

• C#/.Net
• Java
• PHP
• C
• C++
• Zig
• Bash/Shell
• Terraform
• Ansible

AI Tool Configuration

VS Code / GitHub Copilot / Claude

Use the --vscode flag during init to automatically create .vscode/mcp.json:

open-repo-mcp init --vscode

This creates (or updates) .vscode/mcp.json with:

{
	"servers": {
		"open-repo-mcp": {
			"url": "http://localhost:3100/open-repo-mcp/mcp",
			"type": "http"
		}
	},
	"inputs": []
}

If .vscode/mcp.json already exists, the open-repo-mcp server entry is upserted without affecting other servers.

Alternatively, add the configuration manually to .vscode/mcp.json.

MCP Tools

The server exposes 13 tools via MCP:

Environment Variables

CLI Commands

# Initialize server in current repo
open-repo-mcp init [--force] [--vscode]

# Start the MCP server
open-repo-mcp start [--port 3100] [--foreground] [--dev-mode]

# Index the repository
open-repo-mcp index [--port 3100] [--force]

Supported Platforms

Development

# Install dependencies
bun install

# Run server in dev mode
bun run dev:server

# Run CLI in dev mode
bun run dev:cli

# Run tests
bun run test

# Build platform binaries
bun run build

# Build server asset
bun run build:server-asset

# Bump version
bun run version:bump 0.2.0

Contributing

Yes, thank you! This plugin is community-driven, most of its features are from different authors. Please update the docs and tests and add your name to the package.json file.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

License

Copyright (c) 2026 open-repo-mcp Contributors. Licensed under the Apache License 2.0.