MCP server Codeix
Fornece busca semântica de código rápida para agentes de IA, permitindo encontrar símbolos, referências e chamadores em bases de código usando um formato de índice portátil.
Também conhecido como montanetech/codeix
- Stars
- 9
- Ferramentas
- 7
- Downloads, 30 dias
- 69
- Versão mais recente
- 0.5.0
- Último commit
- 21 de fev. de 2026
- Licença
- Apache-2.0
O que é o MCP Codeix?
Fornece busca semântica de código rápida para agentes de IA, permitindo encontrar símbolos, referências e chamadores em bases de código usando um formato de índice portátil. Ele expõe 7 ferramentas, como explore, search, get_file_symbols.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Codeix
Encontrar funções ou classes específicas em bases de código extensas é o que o Codeix possibilita para agentes de codificação de IA. Em vez de forçar um agente a gastar tokens fazendo grep em texto bruto, este MCP server fornece um mapa pré-construído do seu projeto usando um formato .codeindex portátil. Isso permite que os agentes localizem instantaneamente símbolos, assinaturas e relações de parentesco em múltiplos repositórios ou monorepos.
Desenvolvedores utilizam esta ferramenta localmente executando o comando codeix para construir um índice e, em seguida, servindo-o via MCP. Não é necessário uso de chaves de API ou acesso à rede, tornando-o adequado para ambientes air-gapped. O servidor utiliza Rust e tree-sitter para criar dados estruturados que incluem tipos de símbolos e intervalos de linhas. Como o índice é um conjunto de arquivos JSONL, ele pode ser commitado no Git, permitindo que membros da equipe e runners de CI utilizem o mesmo índice pré-construído sem precisar reprocessar o código-fonte.
Através de sete ferramentas específicas, como get_callers e search, os agentes podem navegar por árvores de dependências complexas. O servidor também suporta busca por texto para focar especificamente em docstrings e comentários, garantindo que um agente consiga encontrar um TODO ou uma mensagem de erro sem ser distraído por padrões de código correspondentes.
O que você pode fazer com ele
- 1Localizar definições e assinaturas de funçõesUm agente de IA pode encontrar o intervalo de linhas exato e a assinatura de uma função específica para entender como chamá-la.
- 2Rastrear dependências e referências de códigoUm desenvolvedor pode pedir a um agente para identificar todos os locais em uma base de código que chamam um método específico.
- 3Pesquisar em documentações e comentáriosUm agente pode pesquisar especificamente por texto dentro de docstrings ou comentários para encontrar notas de implementação ou TODOs.
- 4Navegar em monorepos e dependênciasUm agente pode realizar consultas entre diferentes pacotes em um monorepo ou até mesmo navegar pelas APIs de dependências instaladas.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP Codeix
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP Codeix no Claude Code
$ claude mcp add codeix -- npx -y codeixInstalar o MCP Codeix no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codeix": {
"command": "npx",
"args": [
"-y",
"codeix"
]
}
}
}Instalar o MCP Codeix no VS Code
.vscode/mcp.json
{
"servers": {
"codeix": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codeix"
]
}
}
}Instalar o MCP Codeix no VS Code CLI
$ code --add-mcp '{"name":"codeix","type":"stdio","command":"npx","args":["-y","codeix"]}'Instalar o MCP Codeix no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"codeix": {
"command": "npx",
"args": [
"-y",
"codeix"
]
}
}
}Instalar o MCP Codeix no Codex
$ codex mcp add codeix -- npx -y codeixInstalar o MCP Codeix no Codex config.toml
~/.codex/config.toml
[mcp_servers.codeix] command = "npx" args = ["-y", "codeix"]
Instalar o MCP Codeix no Gemini CLI
$ gemini mcp add -s user codeix npx -- -y codeixInstalar o MCP Codeix no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"codeix": {
"command": "npx",
"args": [
"-y",
"codeix"
]
}
}
}Ferramentas do MCP Codeix 7
Detectadas a partir do READMEexploresearchget_file_symbolsget_childrenget_callersget_calleesflush_index
| explore | — | |
| search | — | |
| get_file_symbols | — | |
| get_children | — | |
| get_callers | — | |
| get_callees | — | |
| flush_index | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelmontanetech/codeix is public and reachablegithub.com/montanetech/codeix ↗Passou
- O pacote indica este repositório como sua origemcodeix, codeix name montanetech/codeix as sourcenpmjs.com/package/codeix ↗Passou
- Proveniência da build (atestação Sigstore)Sigstore attestation for codeix, codeixnpmjs.com/package/codeix/v/0.5.0#provenance ↗Passou
- Licença de código aberto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-02-21github.com/montanetech/codeix ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularcodeix looks like @claude-flow/codexProblema encontrado
- Nenhum aviso crítico no pacote ou em suas dependências1 resolved dependencies checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNo tool named like delete, drop or execPassou
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no GitHubcodeix
codeix.dev · Fast semantic code search for AI agents — find symbols, references, and callers across any codebase.
codeix # start MCP server, watch for changes
codeix build # parse source files, write .codeindex
codeix -r ~/project build # build from a specific directory
Why
AI coding agents spend most of their token budget finding code before they can work on it. They grep, read files, grep again, backtrack. On a large codebase the agent might burn thousands of tokens just locating the right function — or worse, miss it entirely and hallucinate.
Codeix gives the agent a pre-built map of your codebase. One structured query returns the symbol name, file, line range, signature, and parent — no scanning, no guessing.
What existing tools get wrong
| Problem | What happens today |
|---|---|
| No structure | grep finds text matches, not symbols. The agent can't distinguish a function definition from a comment mentioning it. |
| Slow re-parsing | Python-based indexers re-parse everything on startup. On large codebases, you wait. |
| Not shareable | Indexes are local caches — ephemeral, per-machine. A new developer or CI runner starts from scratch. |
| No composition | Monorepo with 10 packages? Dependencies with useful APIs? No way to query across boundaries. |
| Prose is invisible | TODOs, docstrings, error messages — searchable by grep but not selectively. You can't search only comments without also matching code. |
What codeix does differently
- Committed to git — the index is a
.codeindexdirectory you commit with your code. Clone the repo, the index is already there. No re-indexing. - Shareable — library authors can ship
.codeindexin their npm/PyPI/crates.io package. Consumers get instant navigation of dependencies. - Composable — the MCP server auto-discovers dependency indexes and mounts them. Query your code and your dependencies in one place.
- Structured for LLMs — symbols have kinds, signatures, parent relationships, and line ranges. The agent gets exactly what it needs in one tool call instead of piecing it together from raw text.
- Prose search —
search --scope texttargets comments, docstrings, and string literals specifically. Find TODOs, find the error message a user reported, find what a function's docstring says — without noise from code. - Fast — builds in seconds, queries in milliseconds. Rust + tree-sitter + in-memory SQLite FTS5 under the hood.
The .codeindex format
An open, portable format for structured code indexing. Plain JSONL files you commit alongside your code — git-friendly diffs, human-readable with grep and jq, no binary blobs.
.codeindex/
index.json # manifest: version, name, languages
files.jsonl # one line per source file (path, lang, hash, line count)
symbols.jsonl # one line per symbol (functions, classes, imports, with signatures)
texts.jsonl # one line per comment, docstring, string literal
Any tool that can parse JSON can consume a .codeindex. Codeix builds it using tree-sitter, and AI agents query it through MCP (Model Context Protocol).
Example — symbols.jsonl:
{"file":"src/main.py","name":"os","kind":"import","line":[1,1]}
{"file":"src/main.py","name":"Config","kind":"class","line":[22,45]}
{"file":"src/main.py","name":"Config.__init__","kind":"method","line":[23,30],"parent":"Config","sig":"def __init__(self, path: str, debug: bool = False)"}
{"file":"src/main.py","name":"main","kind":"function","line":[48,60],"sig":"def main(args: list[str]) -> int"}
Ship your index with your package
Include .codeindex in your package and every developer who depends on you gets instant navigation of your API — no setup, no re-indexing.
Works with Git repos, npm, PyPI, and crates.io.
MCP tools
Seven tools, zero setup. The agent queries immediately — no init, no config, no refresh.
| Tool | What it does |
|---|---|
explore |
Explore project structure: metadata, subprojects, files grouped by directory |
search |
Unified full-text search across symbols, files, and texts (FTS5, BM25-ranked) with scope/kind/path/project filters |
get_file_symbols |
List all symbols in a file |
get_children |
Get children of a class/module |
get_callers |
Find all places that call or reference a symbol |
get_callees |
Find all symbols that a function/method calls |
flush_index |
Flush pending index changes to disk |
Project discovery
Launch codeix from any directory. It walks downward and treats every directory containing .git/ as a separate project — each gets its own .codeindex.
Works uniformly for single repos, monorepos, sibling repos, and git submodules. No config needed.
Languages
Tree-sitter grammars, feature-gated at compile time:
| Language | Feature flag | Default | Extensions |
|---|---|---|---|
| Python | lang-python |
yes | .py .pyi .pyw |
| Rust | lang-rust |
yes | .rs |
| JavaScript | lang-javascript |
yes | .js .mjs .cjs .jsx |
| TypeScript | lang-typescript |
yes | .ts .mts .cts .tsx |
| Go | lang-go |
yes | .go |
| Java | lang-java |
yes | .java |
| C | lang-c |
yes | .c .h |
| C++ | lang-cpp |
yes | .cpp .cc .cxx .hpp .hxx |
| Ruby | lang-ruby |
yes | .rb .rake .gemspec |
| C# | lang-csharp |
yes | .cs |
| Markdown | lang-markdown |
yes | .md .markdown |
Markdown support
Markdown files are parsed for headings (both ATX # and Setext underline styles) which are indexed as section symbols with hierarchical parent-child relationships — enabling TOC extraction and document structure navigation.
Fenced code blocks are extracted as code text entries, parented to their containing section.
Embedded scripts
HTML, Vue, Svelte, and Astro files are preprocessed to extract embedded <script> blocks, which are then parsed with the JavaScript or TypeScript grammar:
| Format | Extensions | Script detection |
|---|---|---|
| HTML | .html .htm |
<script> tags, with optional lang="ts" |
| Vue | .vue |
<script> and <script setup>, with optional lang="ts" |
| Svelte | .svelte |
<script>, with optional lang="ts" |
| Astro | .astro |
--- frontmatter (always TypeScript) + optional <script> tags |
Line numbers in the index point to the original file, not the extracted script block.
Install
# npm / npx — run without installing
npx codeix
# pip / uvx — run without installing
uvx codeix
# Rust
cargo install codeix
# Homebrew
brew install codeix
# Or build from source
git clone https://github.com/montanetech/codeix.git
cd codeix
cargo build --release
All channels install the same single binary. No runtime dependencies.
Usage
# Build the index for the current project
codeix build
# Build from a specific directory (discovers all git repos below)
codeix -r ~/projects build
# Start MCP server (default command, watches for changes)
codeix
# Or explicitly
codeix serve
codeix serve --no-watch
# Serve from a specific directory
codeix -r ~/projects serve
MCP client configuration
Add to your MCP client config (e.g. Claude Desktop, Cursor):
{
"mcpServers": {
"codeix": {
"command": "codeix"
}
}
}
Design principles
- Local only — no network, no API keys, works offline and air-gapped
- Deterministic — same source always produces the same index (clean diffs)
- Composable — dependency indexes are auto-discovered and mounted at query time
- Minimal surface — 7 query tools, zero management plumbing
Architecture
See docs/architecture.md for the full set of architecture decision records.
License
MIT OR Apache-2.0
Perguntas sobre o MCP Codeix
Como adiciono o MCP Codeix ao Claude Code?
Execute claude mcp add codeix -- npx -y codeix no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP Codeix ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais ferramentas o MCP Codeix oferece?
Ele expõe 7 ferramentas, incluindo explore, search, get_file_symbols, get_children, get_callers.
Como o Codeix ajuda agentes de codificação de IA?
Ele fornece um mapa pré-construído da base de código, permitindo que os agentes encontrem símbolos, assinaturas e relações de parentesco em uma única chamada de ferramenta, em vez de escanear texto bruto.
O índice pode ser compartilhado entre desenvolvedores?
Sim, o índice é armazenado em um diretório .codeindex que pode ser commitado no git, permitindo que outros o utilizem sem a necessidade de reindexação.
O Codeix requer conexão com a internet ou chaves de API?
Não, ele foi projetado para ser estritamente local, funcionando offline e em ambientes air-gapped sem qualquer necessidade de rede ou chaves de API.