グラフネイティブなメモリ、ハイブリッドRAG、およびコードベースのインデックス作成を通じて、AIエージェントによるナレッジ管理を可能にします。
別名 GCTRL-TECH/platform, gctrl-mcp
- スター
- 7
- ツール
- 23
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.2.0
- 最終コミット
- 2026年11月6日
- ライセンス
- AGPL-3.0
Ground Control MCPとは
Ground ControlはMCPサーバーです。 グラフネイティブなメモリ、ハイブリッドRAG、およびコードベースのインデックス作成を通じて、AIエージェントによるナレッジ管理を可能にします。. 23個のツールを提供しており、gctrl_extract, gctrl_query, gctrl_search_entitiesなどがあります。
プロジェクトのREADMEから生成された概要
Ground Control MCP server について
Ground Controlは、グラフネイティブなメモリとハイブリッドRAGを使用して、AIエージェントに特化したナレッジ管理システムを提供します。エージェントは、テキストから知識を抽出してNeo4jのエンティティやQdrantのベクトルに格納したり、gctrl_storeツールを通じてObsidianのノートのように構造化された情報を管理したりできます。このサーバーはGCTRLハーネスへの認証済みプロキシとして機能し、接続にはGCTRL_API_TOKENとGCTRL_GATEWAY_URLが必要です。
開発者は、サーバーをダイレクトモードで使用して、ローカルリポジトリをコードベースのナレッジベースとしてインデックス化できます。このモードでは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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Ground Control MCPが提供するツールは
23個のツールを提供しており、gctrl_extract, gctrl_query, gctrl_search_entities, gctrl_list_graphs, gctrl_fuseなどがあります。
コーディングタスクでGCTRLを使用するにはどうすればよいですか?
サーバーをダイレクトモードで実行することで、リポジトリに対するシンボル検索、トレース、影響分析などのローカルコードツールを提供できます。
gctrl_code_indexツールを使用するために必要なものは何ですか?
このツールを使用するには、オプションのgctrl-code-indexerパッケージがインストールされている必要があります。インストールされていない場合は、インストールを促すヒントが返されます。
GCTRLのセキュリティモデルはどのように機能しますか?
特定の権限レベルを持つスコープ付きのGCTRL Access Tokenと、グラフごとの許可設定を使用することで、エージェントが許可されたデータのみにアクセスできるように制御します。