Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Hawkeye AI Bridge

by Hawkeye-Zaragsoftversion 1.0.2i★ 2iRuns on your computerRepository ↗
Registry nameio.github.Hawkeye-Zaragsoft/hawkeye-aibridge

How to install

What it does

Local codebase search for AI assistants via MCP. Requires Hawkeye and Hawkeye AI Bridge installed.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6381 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6051 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2361 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity6/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score13/100

Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 2/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try it

    Use Hawkeye AI Bridge and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Hawkeye AI Bridge or shows a Hawkeye AI Bridge tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Hawkeye AI Bridge yet

Hawkeye AI Bridge runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Hawkeye AI Bridge

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

B · Others in Search & AI memory that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect Hawkeye AI Bridge yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Hawkeye AI Bridge

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Cursor cannot connect Hawkeye AI Bridge yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Hawkeye AI Bridge

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

VS Code cannot connect Hawkeye AI Bridge yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Hawkeye AI Bridge

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Hawkeye AI Bridge💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
No licence stated
Connection
Runs on your computer
Latest versioni
1.0.2
Published to registryi
Jun 2, 2026
Code last changedi
Oct 12, 2026
Maker
Hawkeye-Zaragsoft
Packages
mcpb: …/hawkeye-ai-bridge-1.0.0.mcpb
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account Hawkeye-Zaragsoft, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 39 days ago

  • ! Caution

    Has a licence

    GitHub could not identify the licence type; open the file to check

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/hawkeye-zaragsoft-hawkeye-aibridge.svg)](https://mcp.popnx.com/en/servers/hawkeye-zaragsoft-hawkeye-aibridge)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 83% of the other 6447 servers in this category
  • Published to the registry more recently than 13% of the other 6447 servers in this category
  • Basic checks equal to or better than 50% of the other 6447 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Hawkeye AI Bridge safe?

It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 39 days ago, and the latest version (1.0.2) reached the registry 6 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.3KUpdated 6 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated today

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
Hawkeye AI Bridge
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks2/35/52/44/44/44/4
LicenseNOASSERTIONMITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

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.

  1. Search large projects locally
  2. Reduce token usage from noisy raw search output
  3. Find exact references across code and non-code project files
  4. Useful for C++, C#, Unreal Engine, Unity, legacy projects, and proprietary codebases
  5. Hawkeye runs locally/on-premises and does not use AI for indexing or searching

Table of Contents

  • What is this?
  • Why use Hawkeye AI Bridge?
  • Prerequisites
  • Client Setup
  • Claude Desktop
  • Claude Code (CLI)
  • VS Code / GitHub Copilot
  • Cursor
  • OpenCode
  • Installing the Skill for Claude
  • Available Tools
  • Token Savings
  • Example Prompts
  • Privacy and Security
  • Updating
  • Removing
  • Troubleshooting
  • License
  • Support

What is this?

This repository is the official public setup and discovery repository for using Hawkeye AI Bridge as an MCP server.

It does not contain the proprietary Hawkeye AI Bridge source code. Hawkeye and Hawkeye AI Bridge are proprietary software owned by Zaragsoft.


Why use Hawkeye AI Bridge?

Hawkeye helps developers quickly search and understand large projects. With MCP support, AI coding assistants can ask Hawkeye for fast local search results, saving tokens on each call.

Typical use cases:

  • Find all references to a class, function, symbol, asset, localization key, or file.
  • Search large codebases without relying only on editor search.
  • Help AI coding assistants understand more of the project before making changes.
  • Navigate large game/software projects with less reliance on tribal knowledge.
  • Keep search local/on-premises.
  • ~80% token reduction vs. blind file reading.
  • If you do not specify any groups then all groups will be used.

Prerequisites

  • Hawkeye installed — get it from https://www.zaragsoft.se/downloads
  • Hawkeye AI Bridge installed — get it from https://www.zaragsoft.se/aibridge
  • A local project indexed by Hawkeye
  • Video walkthrough: https://www.youtube.com/watch?v=l1J-G36QSwI

Recommended install path: Place the AIBridge folder at C:\Program Files\Hawkeye\AIBridge\. Use this path in all examples below. If you install elsewhere, substitute your actual path throughout.


Client Setup


Claude Desktop

You don't need this zip for Claude Desktop. Download Hawkeye.mcpb from the release page and install it directly:

  • If .mcpb is a recognised file type on your system: double-click the file.
  • Otherwise: go to Settings → Extensions → Install Extension and select the file.

Claude Code (CLI)
Quick Start (5 steps)
  1. Install Hawkeye from https://www.zaragsoft.se/downloads if you haven't already.
  2. Move the `AIBridge` folder to a permanent location — recommended: C:\Program Files\Hawkeye\AIBridge\. Don't run it from Downloads; the registered path must keep working.
  3. Register the MCP server with Claude Code:
   claude mcp add hawkeye --scope user -- "C:\Program Files\Hawkeye\AIBridge\HawkeyeAIBridge.exe"
  1. Install the Skill so Claude knows when to use Hawkeye. hawkeye-search.skill is a zip archive (it just contains SKILL.md), so it needs to be extracted, not renamed:
   $skillDir = "$env:USERPROFILE\.claude\skills\hawkeye-search"

New-Item -ItemType Directory -Force -Path $skillDir | Out-Null Expand-Archive -Path "C:\Program Files\Hawkeye\AIBridge\hawkeye-search.skill" -DestinationPath $skillDir -Force

5. **Verify** — close and reopen your terminal, then run:
   claude mcp list

You should see hawkeye with 9 tools available.

Make sure Claude Code can find Hawkeye

The MCP server needs to locate hawkeye.exe. Pick one option:

Option A (recommended): Set `HAWKEYE_PATH`

# PowerShell — persistent
:: Command Prompt — persistent

setx HAWKEYE_PATH "C:\Program Files\Hawkeye\hawkeye.exe"

After setting an environment variable, close and reopen your terminal so the new value takes effect.

Option B: Add Hawkeye to PATH via Windows GUI

  1. Press Win, type Environment Variables, open Edit the system environment variables.
  2. Click Environment Variables… → under User variables, select Path → Edit… → New.
  3. Add C:\Program Files\Hawkeye and click OK on all dialogs.
  4. Restart your terminal.

Avoid setx PATH "%PATH%;..." from the command line — it can truncate PATH at 1024 characters. Use the GUI instead.

Notes on the registration command
  • `--scope user` makes Hawkeye available in every Claude Code session, not just the current folder.
  • The `--` separator is required. It tells Claude Code where its own flags end and the registered command begins. Without it, registration may fail.

VS Code / GitHub Copilot

Hawkeye works as an MCP server in VS Code's Copilot Agent mode. Register the exe, then open Copilot Chat in Agent mode.

Quick install (default path)

Click the button above, then click Allow in VS Code.

Manual setup

Add this to your .vscode/mcp.json (create the file if it doesn't exist):

{

"servers": { "hawkeye": { "type": "stdio", "command": "C:\\Program Files\\Hawkeye\\AIBridge\\HawkeyeAIBridge.exe" } } }

To make Hawkeye available across all projects, add it to your user-level config instead:

// %APPDATA%\Code\User\mcp.json

{ "servers": { "hawkeye": { "type": "stdio", "command": "C:\\Program Files\\Hawkeye\\AIBridge\\HawkeyeAIBridge.exe" } } }

Using Hawkeye in Copilot Chat
  1. Open Copilot Chat (Ctrl+Alt+I)
  2. Switch to Agent mode (the dropdown at the top — must be Agent, not Ask or Edit)
  3. Try: *"Search for findTeam in my codebase"*

Note: The hawkeye-search.skill file is for Claude Code and Claude Desktop only — VS Code uses Copilot's own context system and doesn't need it.


Cursor

Open Settings → Tools & MCP → New MCP Server and add:

{

"mcpServers": { "hawkeye": { "command": "cmd", "args": ["/c", "C:\\Program Files\\Hawkeye\\AIBridge\\HawkeyeAIBridge.exe"], "env": {} } } }

Why `cmd /c`? Cursor passes the command path to the shell without quoting it, which breaks paths containing spaces (like C:\Program Files\). Wrapping it with cmd /c works around this.

Adjust the path if Hawkeye AI Bridge is installed somewhere else.


OpenCode

Add the following to your opencode.json (create it in your project root or home directory if it doesn't exist):

{

"$schema": "https://opencode.ai/config.json", "mcp": { "hawkeye": { "type": "local", "command": ["C:\\Program Files\\Hawkeye\\AIBridge\\HawkeyeAIBridge.exe"] } } }

Three things differ from the Claude Code config:

  • The key is "mcp", not "mcpServers"
  • command is an array of strings, not a command + args split
  • "type": "local" is required
Installing the Skill for OpenCode

The Skill is required for OpenCode. Without it, OpenCode will try to call hawkeye.exe directly on the command line rather than routing tool calls through the MCP server.

OpenCode expects skills to be extracted from the .skill zip archive:

$skillDir = "$env:USERPROFILE\.opencode\skills"

New-Item -ItemType Directory -Force -Path $skillDir | Out-Null

$tempZip = "$env:TEMP\hawkeye-search.zip" Copy-Item "C:\Program Files\Hawkeye\AIBridge\hawkeye-search.skill" $tempZip -Force Expand-Archive -Path $tempZip -DestinationPath $skillDir -Force Remove-Item $tempZip

Once both are in place, restart OpenCode and try: *"Find where PlayerController is defined."* You should see it call hawkeye_search_minimal.


Installing the Skill for Claude

The Skill teaches Claude *when* and *how* to use the Hawkeye tools. Without it, Claude has to guess from tool descriptions alone — results will be worse.

The shipped file is called hawkeye-search.skill, but it's actually a zip archive containing a single SKILL.md — it needs to be extracted, not renamed. (Renaming the zip to SKILL.md produces a file with that name but zip contents inside, which Claude can't read as a skill.)

PowerShell (one command):

$skillDir = "$env:USERPROFILE\.claude\skills\hawkeye-search"

New-Item -ItemType Directory -Force -Path $skillDir | Out-Null Expand-Archive -Path "C:\Program Files\Hawkeye\AIBridge\hawkeye-search.skill" -DestinationPath $skillDir -Force

Manual:

  1. Open File Explorer and navigate to %USERPROFILE%\.claude\skills\ (create the skills folder if it doesn't exist).
  2. Create a new folder named hawkeye-search.
  3. Right-click hawkeye-search.skill and choose Extract All..., then extract into the hawkeye-search folder you just created. (Windows recognizes the .skill file as a zip archive even though the extension isn't .zip — if "Extract All" isn't offered, copy the file, rename the copy's extension to .zip, then extract that instead.)
  4. Confirm the result is hawkeye-search\SKILL.md — a plain text file, not the original archive.

To restrict the Skill to a single project, place SKILL.md at \.claude\skills\hawkeye-search\SKILL.md instead.


Available Tools

ToolDescription
hawkeye_search_minimalToken-efficient search — returns only file paths and line numbers. 91% fewer tokens than grep. Best for chat-based lookups.
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. Server-side merging (default mergeGap=8) collapses nearby hits into single blocks.
hawkeye_searchFull search with metadata — returns complete result objects with context. Best for detailed analysis.
hawkeye_get_groupsList all searchable code groups configured in Hawkeye.
hawkeye_get_editorsList configured editors for opening files.

| hawkeye_execute_editor | Open a file in a configured e

Only the beginning is shown; read the rest in the repo