Yapay zeka ajanlarının graph-native bellek, hibrit RAG ve kod tabanı indeksleme yoluyla bilgi yönetimini yapmasını sağlar.
Ayrıca bilinen adı GCTRL-TECH/platform, gctrl-mcp
- Yıldızlar
- 7
- Araçlar
- 23
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.2.0
- Son commit
- 6 Kas 2026
- Lisans
- AGPL-3.0
Ground Control MCP nedir?
Ground Control bir MCP sunucusudur. Yapay zeka ajanlarının graph-native bellek, hibrit RAG ve kod tabanı indeksleme yoluyla bilgi yönetimini yapmasını sağlar. 23 araç sunar; örneğin gctrl_extract, gctrl_query, gctrl_search_entities.
Özet, projenin README dosyasından oluşturuldu
Ground Control MCP sunucusu hakkında
Ground Control, graph-native bellek ve hibrit RAG kullanarak yapay zeka ajanları için özelleşmiş bir bilgi yönetim sistemi sunar. Ajanların metin içerisindeki bilgileri Neo4j varlıklarına ve Qdrant vektörlerine çıkarmasına veya gctrl_store aracı aracılığıyla Obsidian notlarına benzer şekilde yapılandırılmış bilgileri yönetmesine olanak tanır. Sunucu, bir GCTRL harness'ine kimlik doğrulamalı proxy olarak işlev görür ve bağlantı için GCTRL_API_TOKEN ile GCTRL_GATEWAY_URL gerektirir.
Geliştiriciler, yerel depoları bir kod tabanı bilgi tabanına indekslemek için sunucuyu direct mode ile kullanabilirler. Bu mod gctrl_code_index aracını kullanır ve çalışması için isteğe bağlı gctrl-code-indexer paketini gerektirir. İndeksleme tamamlandıktan sonra ajanlar; gctrl_code_symbol, gctrl_code_trace ve gctrl_code_architecture araçlarını kullanarak kod yapıları arasında gezinebilirler. Bu yaklaşım, ajanların gctrl_code_impact ile etki analizi yapmasına ve bilgi grafiği üzerinden karmaşık ilişkileri sorgulamasına olanak tanıyarak, geleneksel metin aramasına kıyasla token kullanımını önemli ölçüde azaltır.
Neler yapabilirsiniz
- 1Metinden yapılandırılmış bilgi çıkarmaBir ajan, ham metni bir bilgi grafiği içindeki düzenli varlıklara ve vektörlere dönüştürebilir.
- 2Kod değişikliği etkilerini analiz etmeBir geliştirici, belirli bir sembolü değiştirmenin kod tabanının geri kalanını nasıl etkileyeceğini belirlemesi için bir ajana soru sorabilir.
- 3Hibrit RAG sorguları gerçekleştirmeKullanıcılar, grafik tabanlı ilişkileri vektör aramasıyla birleştiren karmaşık sorular sorabilirler.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Ground Control MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleGround Control MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' gctrl -- npx -y gctrl-mcpGround Control MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"gctrl": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
}
}
}
}Ground Control MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"gctrl": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
}
}
}
}Ground Control MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"gctrl","type":"stdio","command":"npx","args":["-y","gctrl-mcp"],"env":{"GCTRL_API_TOKEN":"<YOUR_GCTRL_API_TOKEN>"}}'Ground Control MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"gctrl": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
}
}
}
}Ground Control MCP'yi Codex içine yükleyin
$ codex mcp add gctrl --env 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' -- npx -y gctrl-mcpGround Control MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.gctrl] command = "npx" args = ["-y", "gctrl-mcp"] [mcp_servers.gctrl.env] GCTRL_API_TOKEN = "<YOUR_GCTRL_API_TOKEN>"
Ground Control MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' gctrl npx -- -y gctrl-mcpGround Control MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"gctrl": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
}
}
}
}Ground Control MCP araçları 23
README dosyasından algılandıgctrl_extractgctrl_querygctrl_search_entitiesgctrl_list_graphsgctrl_fusegctrl_list_ontologiesgctrl_list_extractionsgctrl_storegctrl_schemagctrl_code_indexgctrl_code_symbolgctrl_code_trace
| gctrl_extract | — | |
| gctrl_query | — | |
| gctrl_search_entities | — | |
| gctrl_list_graphs | — | |
| gctrl_fuse | — | |
| gctrl_list_ontologies | — | |
| gctrl_list_extractions | — | |
| gctrl_store | — | |
| gctrl_schema | — | |
| gctrl_code_index | — | |
| gctrl_code_symbol | — | |
| gctrl_code_trace | — |
23 aracın tümünü gösterDaha az araç göster
gctrl_code_impactgctrl_code_architectureborghive_extractborghive_queryborghive_storeborghive_fuseborghive_search_entitiesborghive_list_graphsborghive_list_ontologiesborghive_list_extractionsborghive_schema
| gctrl_code_impact | — | |
| gctrl_code_architecture | — | |
| borghive_extract | — | |
| borghive_query | — | |
| borghive_store | — | |
| borghive_fuse | — | |
| borghive_search_entities | — | |
| borghive_list_graphs | — | |
| borghive_list_ontologies | — | |
| borghive_list_extractions | — | |
| borghive_schema | — |
Yapılandırma
GCTRL_API_TOKENGerekliGizliScoped GCTRL Access Token (gctrl_…) created in Settings → Access Control
GCTRL_API_URLDirect GCTRL API base URL (alternative to gateway mode), e.g. http://localhost:4000/api
GCTRL_CODE_AUTO_INDEXGCTRL_GATEWAY_URLURL of your GCTRL harness MCP gateway, e.g. http://localhost:4000/api/agent/mcp (recommended mode)
GCTRL_MCP_TOOLS
| Ad | Açıklama | Sunucu |
|---|---|---|
| GCTRL_API_TOKEN | Scoped GCTRL Access Token (gctrl_…) created in Settings → Access Control | GerekliGizli |
| GCTRL_API_URL | Direct GCTRL API base URL (alternative to gateway mode), e.g. http://localhost:4000/api | |
| GCTRL_CODE_AUTO_INDEX | — | |
| GCTRL_GATEWAY_URL | URL of your GCTRL harness MCP gateway, e.g. http://localhost:4000/api/agent/mcp (recommended mode) | |
| GCTRL_MCP_TOOLS | — |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
Ground Control (GCTRL) MCP Server
Exposes Ground Control's knowledge management as MCP tools for Claude and other AI agents.
Tools Available
| Tool | Description |
|---|---|
gctrl_extract |
Extract knowledge from text → Neo4j entities + Qdrant vectors |
gctrl_query |
Ask questions about knowledge graphs (hybrid RAG) |
gctrl_search_entities |
Search for specific entities by name/type |
gctrl_list_graphs |
List all knowledge graph compilations |
gctrl_fuse |
Merge extraction jobs into unified graphs |
gctrl_list_ontologies |
List available ontologies |
gctrl_list_extractions |
List recent extraction jobs |
gctrl_store |
Store knowledge (like Obsidian notes, but with KG extraction) |
gctrl_schema |
Get the knowledge graph schema |
gctrl_code_index |
Index a local repo into a Codebase KB (compilation type CODE). Direct mode only (it indexes THIS machine, so a gateway cannot serve it) and needs the optional gctrl-code-indexer package - without it the tool returns an install hint and every other tool keeps working. |
gctrl_code_symbol |
Find code symbols by name/path/regex (proxied to the HTTP gateway) |
gctrl_code_trace |
Trace callers/callees of a symbol (proxied to the HTTP gateway) |
gctrl_code_impact |
Impact analysis for changed symbols/files (proxied to the HTTP gateway) |
gctrl_code_architecture |
Languages, hotspots, communities for a Codebase KB (proxied to the HTTP gateway) |
Deprecated names (alias, removal in v2)
Every tool above is also exposed under its legacy name for backwards
compatibility with existing .mcp.json configs. The aliases log a
deprecation warning to stderr on every invocation and will be removed
in v2.0 — please migrate.
| Deprecated alias | Use instead |
|---|---|
borghive_extract |
gctrl_extract |
borghive_query |
gctrl_query |
borghive_store |
gctrl_store |
borghive_fuse |
gctrl_fuse |
borghive_search_entities |
gctrl_search_entities |
borghive_list_graphs |
gctrl_list_graphs |
borghive_list_ontologies |
gctrl_list_ontologies |
borghive_list_extractions |
gctrl_list_extractions |
borghive_schema |
gctrl_schema |
Quickstart (npm)
Published on npm as gctrl-mcp and in the
official MCP Registry as io.github.GCTRL-TECH/gctrl. Add to your MCP client config
(Claude Code, Claude Desktop, Cursor, Codex, …):
{
"mcpServers": {
"gctrl": {
"command": "npx",
"args": ["-y", "gctrl-mcp"],
"env": {
"GCTRL_GATEWAY_URL": "http://localhost:4000/api/agent/mcp",
"GCTRL_API_TOKEN": "gctrl_..."
}
}
}
}
Requires a running GCTRL harness (get started).
Coding with GCTRL (recommended for coding agents)
Run the server in direct mode next to your gateway entry so the agent gets the local code tools, and let it keep the repository's Codebase KB current on its own:
{
"mcpServers": {
"gctrl": { "command": "npx", "args": ["-y", "gctrl-mcp"],
"env": { "GCTRL_GATEWAY_URL": "https://<host>/api/agent/mcp", "GCTRL_API_TOKEN": "gctrl_..." } },
"gctrl-code": { "command": "npx", "args": ["-y", "gctrl-mcp"],
"env": { "GCTRL_API_URL": "https://<host>/api", "GCTRL_API_TOKEN": "gctrl_...",
"GCTRL_MCP_TOOLS": "code", "GCTRL_CODE_AUTO_INDEX": "cwd" } }
}
}
With GCTRL_CODE_AUTO_INDEX=cwd the server indexes the directory the MCP client launched it
in (incremental - a warm repo takes seconds) right after start-up, and the agent's first
gctrl_code_symbol hits a current graph. The server's instructions carry the coding
protocol every connected agent follows: index once per session, navigate through
gctrl_code_symbol / gctrl_code_trace / gctrl_code_architecture BEFORE reading files,
run gctrl_code_impact before changing a symbol, re-index after larger edits, ask
gctrl_query for the why and store decisions next to the symbols with gctrl_store.
Measured on GCTRL's own repository: structural questions answered through the graph used
95.6 % fewer tokens than grep-and-read.
Configuration
| Env var | Purpose |
|---|---|
GCTRL_GATEWAY_URL |
Recommended: URL of your harness's MCP gateway (http://<host>:4000/api/agent/mcp). The stdio server acts as a thin authenticated proxy. |
GCTRL_API_URL |
Alternative direct mode: GCTRL API base URL (http://<host>:4000/api); tools run locally against the API. |
GCTRL_API_TOKEN |
Scoped GCTRL Access Token (gctrl_…), created in Settings → Access Control with a clearance level + per-graph grants. Least privilege — the agent sees exactly what the token is cleared for. |
GCTRL_MCP_TOOLS |
Optional tool-set filter. Set to code to register only the local code tools (gctrl_code_index, gctrl_code_symbol, gctrl_code_trace, gctrl_code_impact, gctrl_code_architecture) — used for the Anvil/Hermes gctrl-code stdio entry, kept separate from the HTTP-gateway gctrl/gctrl-projekt entries. Direct mode only: in gateway mode the gateway's own tool list is proxied verbatim, so the filter has no effect and the server says so on startup. |
| GCTRL_CODE_AUTO_INDEX | Direct mode: cwd (or a repository path) indexes that repository in the background right after start-up - incremental, never fatal. Makes the Codebase KB automatic instead of a habit. |
| GCTRL_CODE_COMPILATION_ID | Direct mode: the CODE compilation gctrl_code_index uses when the agent passes none (one project = one repo = one code graph). An explicit compilationId from the agent still wins. |
| GCTRL_CODE_FOLDER | Direct mode: folder path (Users/<name>/Code) for a code graph the server auto-creates as <repo> (code). Hosts that launch the server per user (Anvil) set it so every colleague's code lands in their own folder; without it GCTRL files under the account owner's Users/<owner>/Code. |
Dev-only fallback: GCTRL_EMAIL + GCTRL_PASSWORD (full-clearance JWT). Avoid in production.
Build from source
cd borghive/services/mcp
npm install
npm run build
Working on the code indexer
gctrl-code-indexer is an optional dependency and is not on npm yet, so a plain
npm install here will not fetch it. To develop or test gctrl_code_index against the
in-repo package, link it once:
cd borghive/packages/code-indexer && npm ci && npm run build
cd ../../services/mcp && npm install ../../packages/code-indexer --no-save
# or: npm link ../../packages/code-indexer
The server's types for the indexer are declared locally, so npm run build passes with
or without the package installed - the difference is only whether gctrl_code_index
works at runtime or returns its install hint.
Publish order
gctrl-mcp and gctrl-code-indexer are two npm packages and must go out in this order:
- Publish
gctrl-code-indexer@0.1.0. - Switch
optionalDependenciesinservices/mcp/package.jsonto a real registry range (it already reads^0.1.0; confirm it resolves) and re-runnpm install. - Bump
gctrl-mcpto1.1.0(package.json + package-lock.json root). - Publish
gctrl-mcp.
Bumping gctrl-mcp BEFORE the indexer is on npm would break npx gctrl-mcp for every
existing user - which is exactly why the version sits at 1.0.1 today.
Ground Control MCP soruları
Ground Control MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' gctrl -- npx -y gctrl-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Ground Control MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Ground Control MCP hangi araçları sunar?
23 araç sunar; bunlar arasında gctrl_extract, gctrl_query, gctrl_search_entities, gctrl_list_graphs, gctrl_fuse yer alır.
Kodlama görevleri için GCTRL'yi nasıl kullanabilirim?
Deponuz için sembol arama, izleme (tracing) ve etki analizi gibi yerel kod araçları sağlamak amacıyla sunucuyu direct mode ile çalıştırabilirsiniz.
gctrl_code_index aracını kullanmak için ne gereklidir?
Araç, isteğe bağlı gctrl-code-indexer paketinin yüklü olmasını gerektirir; aksi takdirde bir yükleme ipucu döndürecektir.
GCTRL için güvenlik modeli nasıl çalışır?
Ajanın yalnızca yetkilendirilmiş verileri görmesini sağlamak için belirli yetki seviyelerine ve grafik başına izinlere sahip kapsamlı GCTRL Access Token'ları kullanır.