hawkeye-zaragsoft avatar

Hawkeye AI Bridge

hawkeye-zaragsoft/hawkeye-aibridge-mcp

Connects AI assistants to Hawkeye's local search engine for navigating large codebases without uploading code. Exposes nine MCP tools that let Claude or Copilot find references to classes, functions, symbols, assets, and localization keys across indexed projects. Runs entirely on-premises with no AI-based indexing. The main win is token efficiency: instead of reading files blindly, your assistant queries Hawkeye first and gets back precise locations, cutting context usage by roughly 80%. Requires both Hawkeye and Hawkeye AI Bridge installed locally. Works with Claude Desktop (via .mcpb), Claude Code, VS Code Copilot in Agent mode, Cursor, and OpenCode. Includes a skill file so Claude knows when to reach for search instead of guessing.

tools
12
transport
STDIO
last updated
Jun 1, 2026

Tools

12 tools

Public tool metadata for what this MCP can expose to an agent.

hawkeye_search_minimalToken-efficient search — returns only file paths and line numbers.

Token-efficient search — returns only file paths and line numbers.

No parameter schema in public metadata yet.

hawkeye_expand_contextTakes the {file, lines} hits from hawkeye_search_minimal and returns merged, context-expanded code snippets in one call — no per-range Read calls needed.

Takes the {file, lines} hits from hawkeye_search_minimal and returns merged, context-expanded code snippets in one call — no per-range Read calls needed.

No parameter schema in public metadata yet.

hawkeye_searchFull search with metadata — returns complete result objects with context.

Full search with metadata — returns complete result objects with context.

No parameter schema in public metadata yet.

hawkeye_get_groupsList all searchable code groups configured in Hawkeye.

List all searchable code groups configured in Hawkeye.

No parameter schema in public metadata yet.

hawkeye_get_editorsList configured editors for opening files.

List configured editors for opening files.

No parameter schema in public metadata yet.

hawkeye_execute_editorOpen a file in a configured editor at a specific line number.

Open a file in a configured editor at a specific line number.

No parameter schema in public metadata yet.

hawkeye_health_checkVerify Hawkeye service is running and accessible.

Verify Hawkeye service is running and accessible.

No parameter schema in public metadata yet.

hawkeye_reload_indexTrigger a headless Hawkeye index reload (no window, no stolen focus) on request.

Trigger a headless Hawkeye index reload (no window, no stolen focus) on request.

No parameter schema in public metadata yet.

validate_hawkeye_pathCheck that the configured Hawkeye path exists and is valid.

Check that the configured Hawkeye path exists and is valid.

No parameter schema in public metadata yet.

get_settingsRetrieve current Hawkeye configuration (path, max results, case sensitivity).

Retrieve current Hawkeye configuration (path, max results, case sensitivity).

No parameter schema in public metadata yet.

save_settingsSave Hawkeye configuration.

Save Hawkeye configuration.

No parameter schema in public metadata yet.

copy_to_clipboardCopy text to the system clipboard.

Copy text to the system clipboard.

No parameter schema in public metadata yet.

Sponsors

Readme

Hawkeye AI Bridge MCP Server

Runway at 10M tokens/month - Days until a hypothetical 10M/month context budget is exhausted, if every one of 50 daily search steps looked like this one. Longer bar, more runway.

  • Broad grep - 1.6 days
  • Compact grep - 7.0 days
  • Hawkeye indexed - 29.0 days image

Local codebase search for Claude Code, VS Code, Cursor, and AI agents.

Hawkeye AI Bridge lets AI coding assistants query Hawkeye’s local project index through MCP, so they can find exact references across large codebases, assets, scripts, localization, config files, and project content without uploading the full repository.

Instead of giving an AI agent huge raw grep output, Hawkeye can return compact file/line results that help the agent decide which files are actually worth reading next.


View the full README on GitHub

Details

Repository
github.com/hawkeye-zaragsoft/hawkeye-aibridge-mcp
Category
Search & Web Crawling
Package
https://github.com/Hawkeye-Zaragsoft/hawkeye-aibridge-mcp/releases/download/HawkeyeAIBridge/hawkeye-ai-bridge-1.0.0.mcpb
Transport
STDIO
Registry
MCP registry, active

Related Search & Web Crawling MCP servers

View all
1infoinlet-marketplace avatarMcp Githubinfoinlet-marketplace/marketplaceGitHub for AI agents — repos, files, code search, issues, PRs, commits. Read-only default.0stars
2infoinlet-marketplace avatarMcp Notioninfoinlet-marketplace/marketplaceNotion for AI agents — search, read pages/blocks, query databases, create pages.0stars
3introman2023 avatarTonzar B2B Russian Export Marketplaceintroman2023/tonzar-mcpSearch 160k+ Russian B2B products from 8,900+ verified manufacturers (EN/RU).0stars
4isaacaskew avatarVenuNite Eventsisaacaskew/venunite-eventsFree US local event search. No signup or API key; 90-day lookahead. Paid commercial and bulk access.0stars
5isagelswann avatarCode of Paperisagelswann/codeofpaper-cliFind GitHub implementations of arXiv research papers — paper lookup, ranked code, search.0stars
6agentbase1 avatarOpenClaw Agent Instruction Registryagentbase1/mcp-serverSearch and retrieve agent instruction files: system prompts, skills, workflows, and safety filters.0stars