Graphpilot MCP Server

@graphpilot-oss

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

graphpilot-oss

提交者

akshay sharma

关于 Graphpilot MCP Server

GraphPilot gives coding agents persistent structural knowledge of a codebase. It parses TypeScript/JavaScript with tree-sitter into a graph of symbols and call edges, then exposes that graph over MCP so the agent can recall definitions, find callers, and trace change impact witho

#mcp #model-context-protocol #code-intelligence#structural-memory#typescript #javascript #tree-sitter #static-analysis #call-graph #code-navigation #refactoring #impact-analysis #developer-tools #coding-agents #local-first

Graphpilot MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "graphpilot": {
      "command": "npx",
      "args": [
        "-y",
        "@graphpilot-oss/graphpilot",
        "mcp"
      ]
    }
  }
}

Graphpilot MCP Server 工具

Re-index the repo after batch edits so subsequent gp_* calls see your changes. Call after any non-trivial edit session. Do NOT call before every query — indexing is slow; only needed when source files changed.

Find a symbol definition by name — returns kind, file:line, and signature. ALWAYS use instead of `grep -rn "function X"` or reading files to locate a definition: pre-indexed, no false positives from comments or strings, sub-millisecond. Pass substring:true for partial-name searches. Do NOT use for "who calls X?" — use gp_callers for that.

List every caller of a symbol (direction=callers) or everything it calls (direction=callees). ALWAYS use instead of `grep -rn "X("` for "who calls X?" — pre-indexed reverse map, sub-millisecond, no false positives from comments or strings. Use direction=callers to find dependents before a rename; direction=callees to understand what a function depends on. Do NOT use for full blast-radius analysis across multiple hops — use gp_impact instead.

Compute the blast radius of a rename or signature change: direct callers, transitive callers up to depth 3, affected tests, and whether the symbol is exported (breaking-change risk). ALWAYS call before proposing a rename, signature change, or behavior change — replaces `git diff | xargs grep` with a single structured answer. Pass `since: <commit|branch>` to scope callers to files changed since that ref (ideal for PR review or refactor scoping). Do NOT use just to see direct callers; use gp_callers for that.

概览

What is Graphpilot?

Graphpilot is a local CLI + MCP server that indexes TypeScript/JavaScript repos into a structural graph (symbols, callers, callees, blast radius) and exposes it to coding agents like Claude Code, Cursor, and Cline, so they stop grepping the same files every session. It runs entirely on your machine and serves as persistent structural memory between agent sessions, reducing token usage and hallucinations.

How to use Graphpilot?

Install the package globally (npm install -g @graphpilot-oss/graphpilot), then run graphpilot index <path> once to build the graph. For agent integration, add a two-line MCP server entry to your agent's configuration pointing to graphpilot mcp. Optionally run graphpilot watch <path> for sub-second incremental updates and graphpilot init to write editor rules that teach the agent to use the gp_* tools.

Key features of Graphpilot

Evidence anchors with file:line@sha on every result
Differential impact scoped to branch changes via since
Worktree‑aware indexing without manual configuration
Local‑first, zero telemetry, deterministic graph
Sub‑second incremental watch mode updates
Four MCP tools: gp_recall, gp_callers, gp_impact, gp_index

Use cases of Graphpilot

Find all callers of a function before refactoring
Assess blast radius of renaming a symbol up to depth 5
Perform PR‑scoped impact analysis using branch filter
Locate a symbol definition quickly without grep
Keep agent’s structural knowledge fresh via watch mode

常见问题

What are the prerequisites for using Graphpilot?

Node.js ≥20, an MCP‑capable coding agent (Claude Code, Cursor, Cline, Windsurf, or Continue), and a TypeScript or JavaScript repository to index.

How does Graphpilot compare to grep?

In a benchmark on 10 structural queries, Graphpilot achieved F1 0.89 vs grep’s 0.42 while reading 99.9% fewer bytes (721 B vs 528 KB). An agent using Graphpilot on 40 questions used 61% fewer tokens and cost $3.68 instead of $8.88.

Does Graphpilot send any data off my machine?

No. Graphpilot is local‑first by design — it has no telemetry, no remote calls, and the

其他分类下的更多 MCP 服务器

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi