Feature/new mcp tools for symbol analysis and cross repo query

[tuanphuong-dev]

Summary

Adds 5 new MCP tools for symbol analysis and cross-repository querying, expanding the toolkit from 7 to 12 tools. This enables AI agents to perform more granular code navigation, fetch source code directly, and query across multiple indexed repositories.

What's New

New MCP Tools

1. find_referencing - Lightweight 1-hop caller discovery

• Finds all symbols that directly call, import, extend, or implement a given symbol
• Supports filtering by edge type (CALLS, IMPORTS, EXTENDS, IMPLEMENTS, MEMBER_OF)
• Example: "What calls UserService.GetUser?"

2. symbol_coordinates - Precise location lookup

• Returns exact file path and line range for any symbol
• Essential for agents before editing code
• Example: "Where is ProcessOrder defined?"

3. get_symbols_overview - File structure exploration

• Lists all top-level symbols in a file, sorted by line number
• Excludes nested methods and members
• Supports filtering for exported symbols only
• Example: "What's exported from store.go?"

4. find_symbol_body - Source code retrieval

• Fetches the exact source code body of a function/method/class
• Includes file path, line range, and full implementation text
• Useful when debugging from logs or stack traces

5. query_repo - Cross-repository querying

• Execute whitelisted read-only tools against different indexed repositories
• Allows agents to work across multiple codebases
• Whitelisted tools: query, context, find_referencing, symbol_coordinates, get_symbols_overview,
  impact

Documentation Updates

• Updated README with new tool count (12 tools) and descriptions
• Added recommended workflow incorporating new tools
• Updated MCP testing instructions with browser-based Inspector UI

Usage Example

Using MCP Inspector to explore tools

npx @modelcontextprotocol/inspector ./bin/mimir mcp

Then explore all 12 tools via the browser UI at http://localhost:6274