english/.opencode/skills/gkg/references/mcp-tools.md

GKG MCP Tools

7 Model Context Protocol tools for AI assistants. Available when server runs with --register-mcp.

Endpoints

• HTTP: http://localhost:27495/mcp
• SSE: http://localhost:27495/mcp/sse

Tools

list_projects

List all indexed projects with paths.

Use: Discover available codebases before analysis.

Returns: Project names and absolute paths.

search_codebase_definitions

Search for functions, classes, methods, constants, interfaces.

Parameters:

• query: Search terms
• limit: Max results (pagination)

Use: Find symbol definitions by name pattern.

Returns: Matching definitions with FQN and locations.

index_project

Re-index a project to reflect code changes.

Parameters:

• project_path: Path to project

Use: Update graph after code modifications.

Returns: Statistics (files processed, definitions found).

get_references

Find all usages of a specific definition.

Parameters:

• definition_id: Symbol identifier
• project_path: Project context

Use: Impact analysis, find call sites before refactoring.

Returns: All locations where symbol is referenced.

read_definitions

Retrieve complete source code for multiple symbols.

Parameters:

• definition_ids: List of symbol IDs

Use: Batch-read implementations. Token-efficient for same-file symbols.

Returns: Full definition bodies.

get_definition

Navigate to definition of a call on specific line.

Parameters:

• file_path: Source file
• line: Line number
• column: Column position

Use: Go-to-definition for function/method calls.

Returns: Definition location (handles workspace and external deps).

repo_map

Generate token-efficient ASCII tree of repository structure.

Parameters:

• project_path: Repository path
• depth: Tree depth limit

Use: Quick codebase overview for LLMs.

Returns: Compact tree with condensed definitions, human-readable.

Integration Pattern

1. list_projects → discover codebases
2. search_codebase_definitions → find symbols
3. read_definitions → get implementations
4. get_references → find usages
5. repo_map → architecture overview