forge-mcp

Overview ¶

Command forge-mcp is a standalone Model Context Protocol stdio server that hosts a forge project's gen/mcp/manifest.json — every Connect RPC becomes an MCP tool. It is a thin wrapper over internal/mcpbridge; the `forge mcp serve` subcommand wraps the same package and is the preferred entry point (it resolves the server address from forge.yaml). This standalone binary exists for clients that prefer a dedicated executable or want to point at an arbitrary manifest/address without a forge project on disk.

Usage:

forge-mcp --addr http://localhost:8080                 # call a running Connect server
forge-mcp --addr http://... --auth "Bearer xxx"        # propagate an Authorization header
forge-mcp --addr http://... --auth-env FORGE_MCP_TOKEN # ... or read it from env
forge-mcp --addr http://... --manifest <path>          # explicit manifest
forge-mcp --addr http://... --project <dir>            # resolves <dir>/gen/mcp/manifest.json

stdout is reserved for the MCP protocol; diagnostics go to stderr.