is an AI-powered code intelligence platform that helps LLMs and developers deeply understand large codebases — combining multi-language AST parsing, a Neo4j knowledge graph, pgvector semantic search, and a pluggable LLM backend, all exposed via the .
GoAtlas: The AI-Powered Code Intelligence Engine — A server-side MCP platform that deeply indexes Go/TypeScript codebases via AST parsing, builds a Neo4j knowledge graph, and provides hybrid semantic search (BM25 + pgvector). Features process detection, community clustering, auto-generated docs, and a Gemini AI agent.
Estrelas
34
Ferramentas
—
Disponibilidade
—
GoAtlas
Model Context Protocol (MCP)
What Makes It Different
Multi-Language — Go, TypeScript/JSX, Python, and Java parsed via AST (tree-sitter); symbols, endpoints, imports extracted per language
Zero-Config Auto-Discovery — Reads go.mod, package.json, requirements.txt, pom.xml to automatically activate connection detection patterns for gRPC, Kafka, HTTP clients, and more
Cross-Service Connection Detection — Detects inter-service connections (gRPC, Kafka, HTTP) across Go, TS, Python, and Java with no config required
Knowledge Graph — Neo4j graph of packages, files, functions, types with import/call/implementation edges
Hybrid BM25 + Semantic Search — Reciprocal Rank Fusion merges keyword and vector results; semantic search via Gemini or Ollama embeddings
Process & Community Detection — BFS from entry points traces execution flows; Louvain clustering groups code communities
Pluggable LLM — Supports Gemini (gemini-2.0-flash), Ollama (any local model), and any OpenAI-compatible API (vLLM, LiteLLM, etc.) for both embeddings and agentic Q&A
MCP Server — 22 tools, 5 resources, 3 prompts via stdio for Cursor, Claude Desktop, and any MCP client
Claude Code Hooks — SessionStart/PreToolUse/PostToolUse integration for session context injection, semantic enrichment, and incremental re-indexing
AI-Generated Docs — SKILL.md per community cluster and full Markdown wiki from the knowledge graph
Replace /path/to/goatlas with the actual binary path (e.g. ~/go/bin/goatlas). Run which goatlas to find it.
Tip: You can use both hooks and MCP together — hooks handle background enrichment and re-indexing, while MCP gives you direct tool access from the chat interface.
LLM Providers
GoAtlas supports Gemini (default), Ollama (local), and any OpenAI-compatible API (vLLM, LiteLLM, text-generation-inference, LocalAI, etc.) for both chat and embeddings, configured independently.
Variable
Default
Description
LLM_PROVIDER
gemini
Chat/agent provider: gemini | ollama | openai
EMBED_PROVIDER
gemini
Embedding provider: gemini | ollama | openai
GEMINI_API_KEY
—
Required when using Gemini
OLLAMA_URL
http://localhost:11434
Ollama server URL
OLLAMA_MODEL
llama3.2
Ollama chat model
OLLAMA_EMBED_MODEL
nomic-embed-text
Ollama embedding model
OPENAI_BASE_URL
http://localhost:8001/v1
OpenAI-compatible API base URL
OPENAI_API_KEY
—
API key (use ignored for servers that don't need auth)
OPENAI_MODEL
gpt-3.5-turbo
OpenAI-compatible chat model
OPENAI_EMBED_BASE_URL
same as OPENAI_BASE_URL
Separate base URL for embedding requests (useful when running chat and embed on different servers)
goatlas index <path> # index a repository
goatlas index --force <path> # force re-index all files
goatlas index --incremental <path> # only changed files since last commit
goatlas embed # generate vector embeddings
goatlas embed --force # re-embed everything
goatlas build-graph # populate Neo4j knowledge graph
goatlas detect # process + community detection
goatlas ask "<question>" # single-shot AI Q&A
goatlas chat # interactive multi-turn session
goatlas serve # start MCP server (stdio)
goatlas skills generate <path> # generate SKILL.md per community
goatlas wiki <output-dir> # generate Markdown wiki
goatlas check-coverage spec.md # spec implementation coverage
goatlas hooks install <path> # install Claude Code hooks
goatlas migrate # run database migrations
Environment Variables
Variable
Default
Description
DATABASE_DSN
postgres://goatlas:goatlas@localhost:5432/goatlas
PostgreSQL DSN
QDRANT_URL
—
Qdrant gRPC endpoint (empty = use pgvector)
NEO4J_URL
bolt://localhost:7687
Neo4j Bolt endpoint
NEO4J_USER
neo4j
Neo4j username
NEO4J_PASS
goatlas_neo4j
Neo4j password
GEMINI_API_KEY
—
Google Gemini API key
LLM_PROVIDER
gemini
LLM backend: gemini | ollama | openai
EMBED_PROVIDER
gemini
Embedding backend: gemini | ollama | openai
OLLAMA_URL
http://localhost:11434
Ollama server URL
OLLAMA_MODEL
llama3.2
Ollama chat model
OLLAMA_EMBED_MODEL
nomic-embed-text
Ollama embedding model
OPENAI_BASE_URL
http://localhost:8001/v1
OpenAI-compatible API base URL
OPENAI_API_KEY
—
API key (use ignored if not needed)
OPENAI_MODEL
gpt-3.5-turbo
OpenAI-compatible chat model
OPENAI_EMBED_BASE_URL
same as OPENAI_BASE_URL
Separate base URL for embedding requests
OPENAI_EMBED_MODEL
text-embedding-ada-002
OpenAI-compatible embedding model
REPO_PATH
cwd
Default repository path
Development
make build # compile binary
make test # run tests
make lint # run linter
make docker-up # build & start all services (migrations run automatically)
make docker-down # stop all services
make migrate # run migrations manually (local dev without Docker)
License
MIT
G
Goatlas
xdotech·34 estrelas·
GoAtlas: The AI-Powered Code Intelligence Engine — A server-side MCP platform that deeply indexes Go/TypeScript codebases via AST parsing, builds a Neo4j knowledge graph, and provides hybrid semantic
GoAtlas: The AI-Powered Code Intelligence Engine — A server-side MCP platform that deeply indexes Go/TypeScript codebases via AST parsing, builds a Neo4j knowledge graph, and provides hybrid semantic search (BM25 + pgvector). Features process detection, community clustering, auto-generated docs, and a Gemini AI agent.
Ferramentas
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Goatlas?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Goatlas usa?
Goatlas roda localmente via stdio.
Quando Goatlas foi verificado pela última vez?
Última verificação: 2026-10-28. GoAtlas: The AI-Powered Code Intelligence Engine — A server-side MCP platform that deeply indexes Go/TypeScript codebases via AST parsing, builds a Neo4j knowledge graph, and provides hybrid semantic search (BM25 + pgvector). Features process detection, community clustering, auto-generated docs, and a Gemini AI agent.