Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@GID MCP Server What breaks if I change UserService?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Model Context Protocol server for Graph-Indexed Development
Give AI assistants structural awareness of your codebase. GID represents software systems as typed, directed graphs — so AI can reason about architecture, not just syntax.
AI can generate code, but it can't answer:
"What breaks if I change UserService?"
"Which components implement the auth feature?"
"What's the dependency path from Controller to Database?"
GID fills this gap by providing a graph-based map of your software architecture that AI assistants can query and update.
Two workflows:
Top-down: Describe what you want to build → GID generates the architecture graph → AI implements against it
Bottom-up: Extract a graph from existing code → Use it for impact analysis, safe refactoring, and planning new changes
The graph evolves with your project. Every time you add a feature or refactor, the graph updates — so AI always has the current map.
Dogfooding: GID's own architecture is defined as a GID graph. We used GID to build GID — tracking components, querying impact before refactoring, and planning new features. See the self-referential graph.
Related MCP server: Axon Pro
Tool | Description |
| Analyze what components and features are affected by changing a node |
| Get dependencies or dependents of a node (with depth control) |
| Find shared dependencies between two nodes (useful for debugging) |
| Find dependency path between two nodes |
| Deep analysis of a file (functions, classes, complexity) |
| Structured file analysis for AI summarization |
| Graph health score, validation issues, and improvement suggestions |
| Get the GID graph schema with dynamic relations |
Tool | Description |
| Read graph structure (YAML, JSON, or summary) |
| Initialize a new GID graph in a project |
| Add, update, or delete nodes, edges, and relation types |
| Rename, move, or delete nodes with cascade |
| Version history — list, diff, or restore previous versions |
Tool | Description |
| Generate a graph from natural language requirements |
| Extract dependency graph from existing code (TypeScript/JavaScript) |
| Propose semantic upgrades — map files to components, assign layers, detect features |
| Analyze docs to identify gaps and suggest graph additions |
| Generate interactive D3.js HTML visualization |
Resource | Description |
| Current dependency graph (YAML) |
| Health score and validation results |
| List of all features in the graph |
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"gid": {
"command": "npx",
"args": ["graph-indexed-development-mcp"]
}
}
}claude mcp add gid -- npx graph-indexed-development-mcpAdd to your MCP settings:
{
"gid": {
"command": "npx",
"args": ["graph-indexed-development-mcp"]
}
}Install the MCP server (see above)
Initialize a graph in your project:
You: "Initialize a GID graph for this project"
→ Claude uses gid_initExtract dependencies from your code:
You: "Extract the dependency graph from the codebase"
→ Claude uses gid_extractStart querying:
You: "What would break if I change UserService?"
→ Claude uses gid_query_impact
You: "Design the architecture for a notification feature"
→ Claude uses gid_design
You: "Show me the project health score"
→ Claude uses gid_adviseYou: "Design an e-commerce backend with auth, payments, and order tracking"
Claude uses gid_design →
Created 4 features: UserAuth, Payment, OrderTracking, ProductCatalog
Created 8 components across 4 layers
Created 15 dependency edges
Health score: 95/100
You: "Now implement the AuthService based on the graph"
Claude uses gid_query_deps →
AuthService depends on: UserRepository, TokenManager
Implements: UserAuth feature
Layer: application
Claude generates code that fits the architecture.You: "Extract the dependency graph from this project"
Claude uses gid_extract →
Found 42 files, 156 dependencies
Grouped into 12 components across 4 layers
You: "I need to refactor UserService. What would break?"
Claude uses gid_query_impact →
Direct dependents: AuthController, ProfileController, OrderService
Affected features: UserRegistration, OrderPayment
5 components impacted, 2 features at risk
You: "Why do OrderService and PaymentService keep failing together?"
Claude uses gid_query_common_cause →
Shared dependency: DatabaseService
Both services depend on it — that's likely the root cause.You: "I just added a NotificationService. Update the graph."
Claude uses gid_edit_graph →
Added node: NotificationService (Component, application layer)
Added edges: depends_on EmailClient, implements Notifications feature
You: "Check the project health"
Claude uses gid_advise →
Health: 87/100
Warning: NotificationService has no tests
Warning: EmailClient has 6 dependents (high coupling)
Suggestion: Consider splitting EmailClient into smaller modulesYou: "Visualize the current project architecture"
Claude uses gid_visual → Generates an interactive D3.js HTML file
GID uses a YAML-based graph format (.gid/graph.yml):
nodes:
UserAuth:
type: Feature
description: User authentication and authorization
priority: core
status: active
AuthService:
type: Component
layer: application
description: Handles authentication logic
path: src/services/auth.ts
AuthController:
type: Component
layer: interface
path: src/controllers/auth.ts
edges:
- from: AuthService
to: UserAuth
relation: implements
- from: AuthController
to: AuthService
relation: depends_onNode types: Feature, Component, Interface, Data, File, Test, Decision
Relation types: implements, depends_on, calls, reads, writes, tested_by, defined_in, enables, blocks, requires, precedes, refines, validates, related_to, decided_by — plus custom relations you define.
Nodes can have an optional tasks field for inline step tracking:
webhook-push:
type: Component
layer: infrastructure
status: in_progress
description: "Webhook push notifications HMAC-SHA256"
tasks:
- "[x] Implement HMAC signing"
- "[x] DM webhook events"
- "[ ] Run migration 011 on prod"
- "[ ] Add retry logic"Convention: When all tasks are done, remove the tasks field and set status: active.
Tool | Description |
| Query tasks across the graph. No args = all pending. |
| Toggle task completion: |
| Now shows tasks inline in summary output |
webhook-push [Component, infrastructure, in_progress]
"Webhook push notifications HMAC-SHA256"
Tasks: 2/4 done
✅ Implement HMAC signing
✅ DM webhook events
☐ Run migration 011 on prod
☐ Add retry logicNode.js >= 20.0.0
GID Methodology — Specification, examples, and dogfood graph
GID CLI — Command line interface
GID Paper — Formal methodology (Zenodo)
AGPL-3.0 — See LICENSE for details.
For commercial licensing, see COMMERCIAL-LICENSE.md.
Toni Tang — @tonioyeme
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
AI Agent with Architectural Memory. Impact analysis (free), tests and code from the graph (pro).
AI knowledge graph for architecture, portfolio, and digital strategy management.
Give your AI agent a persistent map of your project's structure, dependencies, and bugs.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/potatouniverse/graph-indexed-development-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
