How do I install Hawkeye AI Bridge?

You can install Hawkeye AI Bridge by adding it to your MCP client configuration (Cursor, Claude, VS Code, etc.) or by using the Stork MCP meta-server to discover and configure it automatically.

Hawkeye AI Bridge

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

build.protocol_tooling.mcp

Visit Homepage

Back to MCP Servers

Install Hawkeye AI Bridge in your MCP client

Hawkeye AI Bridge is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

Locate your client's MCP config file.
- Cursor: ~/.cursor/mcp.json
- Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
- Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
- VS Code: Settings → Extensions → MCP
- Windsurf: Settings → MCP Servers
Add Hawkeye AI Bridge to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
Restart your client so it picks up the new server.
Verify — ask the assistant to list available tools; Hawkeye AI Bridge's tools should appear.

{
  "mcpServers": {
    "hawkeye-ai-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@hawkeye-ai-bridge/mcp-server"
      ],
      "note": "Replace with the actual package name from the server's documentation."
    }
  }
}

Install Hawkeye AI Bridge in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. Hawkeye AI Bridge will show up in the assistant's tool list on next launch.

Install Hawkeye AI Bridge in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). Hawkeye AI Bridge will show up in the assistant's tool list on next launch.

Install Hawkeye AI Bridge in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). Hawkeye AI Bridge will show up in the assistant's tool list on next launch.

Install Hawkeye AI Bridge in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. Hawkeye AI Bridge will show up in the assistant's tool list on next launch.

Transport

Hawkeye AI Bridge supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

Other Model Context Protocol servers in the same space as Hawkeye AI Bridge. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.