그래프 네이티브 메모리, 하이브리드 RAG, 코드베이스 인덱싱을 통해 AI 에이전트의 지식 관리를 지원합니다.
다른 이름 GCTRL-TECH/platform, gctrl-mcp
- 스타
- 7
- Tools
- 23
- 다운로드, 30일
- —
- 최신 버전
- 1.2.0
- 마지막 커밋
- 2026년 11월 6일
- 라이선스
- AGPL-3.0
Ground Control MCP란?
Ground Control은(는) MCP server입니다. 그래프 네이티브 메모리, 하이브리드 RAG, 코드베이스 인덱싱을 통해 AI 에이전트의 지식 관리를 지원합니다. 23개 도구를 제공합니다. 예: gctrl_extract, gctrl_query, gctrl_search_entities.
프로젝트 README에서 생성된 요약
Ground Control MCP server 정보
Ground Control은 그래프 네이티브 메모리와 하이브리드 RAG를 사용하여 AI 에이전트를 위한 특화된 지식 관리 시스템을 제공합니다. 에이전트는 텍text에서 지식을 추출하여 Neo4j 엔티티와 Qdrant 벡터로 저장하거나, gctrl_store 도구를 통해 Obsidian 노트와 유사한 구조화된 정보를 관리할 수 있습니다. 이 서버는 GCTRL harness에 대한 인증 프록시 역할을 하며, 연결을 위해 GCTRL_API_TOKEN과 GCTRL_GATEWAY_URL이 필요합니다.
개발자는 서버를 direct mode로 사용하여 로컬 저장소를 코드베이스 지식 베이스로 인덱싱할 수 있습니다. 이 모드는 gctrl_code_index 도구를 사용하며 작동을 위해 선택 사항인 gctrl-code-indexer 패키지가 필요합니다. 인덱싱이 완료되면 에이전트는 gctrl_code_symbol, gctrl_code_trace, gctrl_code_architecture를 사용하여 코드 구조를 탐색할 수 있습니다. 이러한 접근 방식은 gctrl_code_impact를 통한 영향 분석을 가능하게 하고 지식 그래프를 통해 복잡한 관계를 쿼리할 수 있게 하여, 기존의 텍스트 검색 방식보다 토큰 사용량을 크게 줄여줍니다.
활용 사례
- 1텍스트에서 구조화된 지식 추출에이전트가 가공되지 않은 텍스트를 지식 그래프 내의 조직화된 엔티티와 벡터로 변환할 수 있습니다.
- 2코드 변경 영향 분석개발자가 에이전트에게 특정 심볼을 변경할 때 코드베이스의 나머지 부분에 어떤 영향을 미칠지 확인하도록 요청할 수 있습니다.
- 3하이브리드 RAG 쿼리 수행사용자는 그래프 기반 관계와 벡터 검색을 결합한 복잡한 질문을 던질 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Ground Control MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Ground Control MCP 설치
$ claude mcp add --env 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' gctrl -- npx -y gctrl-mcpCursor에 Ground Control MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"gctrl": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
}
}
}
}VS Code에 Ground Control MCP 설치
.vscode/mcp.json
{
"servers": {
"gctrl": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
}
}
}
}VS Code CLI에 Ground Control MCP 설치
$ code --add-mcp '{"name":"gctrl","type":"stdio","command":"npx","args":["-y","gctrl-mcp"],"env":{"GCTRL_API_TOKEN":"<YOUR_GCTRL_API_TOKEN>"}}'Claude Desktop에 Ground Control MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"gctrl": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
}
}
}
}Codex에 Ground Control MCP 설치
$ codex mcp add gctrl --env 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' -- npx -y gctrl-mcpCodex config.toml에 Ground Control MCP 설치
~/.codex/config.toml
[mcp_servers.gctrl] command = "npx" args = ["-y", "gctrl-mcp"] [mcp_servers.gctrl.env] GCTRL_API_TOKEN = "<YOUR_GCTRL_API_TOKEN>"
Gemini CLI에 Ground Control MCP 설치
$ gemini mcp add -s user -e 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' gctrl npx -- -y gctrl-mcpGemini settings.json에 Ground Control MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"gctrl": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
}
}
}
}Ground Control MCP 도구 23
README에서 감지됨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개 모두 보기도구 수 줄이기
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 | — |
구성
GCTRL_API_TOKEN필수비밀Scoped 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
| 이름 | 설명 | 유형 |
|---|---|---|
| GCTRL_API_TOKEN | Scoped GCTRL Access Token (gctrl_…) created in Settings → Access Control | 필수비밀 |
| 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 | — |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기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 질문
Ground Control MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' gctrl -- npx -y gctrl-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Ground Control MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Ground Control MCP는 어떤 도구를 제공하나요?
23개 도구를 제공합니다. 예: gctrl_extract, gctrl_query, gctrl_search_entities, gctrl_list_graphs, gctrl_fuse.
코딩 작업에 GCTRL을 어떻게 활용할 수 있나요?
서버를 direct mode로 실행하여 심볼 검색, 트레이싱, 영향 분석과 같은 로컬 코드 도구를 저장소에 제공할 수 있습니다.
gctrl_code_index 도구를 사용하려면 무엇이 필요한가요?
이 도구는 선택 사항인 gctrl-code-indexer 패키지 설치가 필요하며, 설치되어 있지 않으면 설치 안내 메시지가 반환됩니다.
GCTRL의 보안 모델은 어떻게 작동하나요?
특정 권한 수준과 그래프별 승인 권한을 가진 범위 제한형 GCTRL Access Token을 사용하여 에이전트가 허가된 데이터만 볼 수 있도록 보장합니다.