SearchForge MCP Server

by divyanshu-iitianio.github.divyanshu-iitian/searchforgev0.2.0

Capability-routed search and web reading across GitHub, Crossref, Hacker News, Wikipedia and private SearXNG, plus URL-to-Markdown and health diagnostics.

2Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install SearchForge MCP server

claude mcp add searchforge -e GITHUB_TOKEN='<github-token>' -e BRAVE_SEARCH_API_KEY='<brave-search-api-key>' -- docker run -i --rm -e GITHUB_TOKEN -e BRAVE_SEARCH_API_KEY ghcr.io/divyanshu-iitian/searchforge-mcp:0.2.0

{
  "mcpServers": {
    "searchforge": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_TOKEN",
        "-e",
        "BRAVE_SEARCH_API_KEY",
        "ghcr.io/divyanshu-iitian/searchforge-mcp:0.2.0"
      ],
      "env": {
        "GITHUB_TOKEN": "<github-token>",
        "BRAVE_SEARCH_API_KEY": "<brave-search-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "searchforge": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_TOKEN",
        "-e",
        "BRAVE_SEARCH_API_KEY",
        "ghcr.io/divyanshu-iitian/searchforge-mcp:0.2.0"
      ],
      "env": {
        "GITHUB_TOKEN": "<github-token>",
        "BRAVE_SEARCH_API_KEY": "<brave-search-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "searchforge": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_TOKEN",
        "-e",
        "BRAVE_SEARCH_API_KEY",
        "ghcr.io/divyanshu-iitian/searchforge-mcp:0.2.0"
      ],
      "env": {
        "GITHUB_TOKEN": "<github-token>",
        "BRAVE_SEARCH_API_KEY": "<brave-search-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "searchforge": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_TOKEN",
        "-e",
        "BRAVE_SEARCH_API_KEY",
        "ghcr.io/divyanshu-iitian/searchforge-mcp:0.2.0"
      ],
      "env": {
        "GITHUB_TOKEN": "<github-token>",
        "BRAVE_SEARCH_API_KEY": "<brave-search-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
SEARCHFORGE_SEARXNG_URL	—	—	Optional URL of a self-hosted SearXNG instance
GITHUB_TOKEN	—	yes	Optional GitHub token for higher public API quotas
CROSSREF_MAILTO	—	—	Optional email address for Crossref polite-pool routing
BRAVE_SEARCH_API_KEY	—	yes	Optional Brave Search API key

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-25 · 3mo ago · GitHub
Latest release
2026-07-24 · 3mo ago · GitHub · v0.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-24 · 3mo ago · official registry · v0.2.0

FAQ

›How do I install the SearchForge MCP server in Claude Code?

Run: claude mcp add searchforge -e GITHUB_TOKEN='<github-token>' -e BRAVE_SEARCH_API_KEY='<brave-search-api-key>' -- docker run -i --rm -e GITHUB_TOKEN -e BRAVE_SEARCH_API_KEY ghcr.io/divyanshu-iitian/searchforge-mcp:0.2.0. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does SearchForge require an API key?

Yes. It expects GITHUB_TOKEN, BRAVE_SEARCH_API_KEY, of which 2 are secrets.

›Can I use SearchForge as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is SearchForge in the official MCP registry?

Yes, as io.github.divyanshu-iitian/searchforge.