Skip to content

MCP Server

farscry ships a built-in MCP server. Run it once - OCR engines load at startup and stay warm in memory, eliminating cold-start overhead on every call.

Terminal window
farscry serve --mcp
Listening on unix socket (default)
farscry serve --mcp --port 3333
Listening on localhost:3333

Why daemon mode

ModeApple Siliconx86
CLI cold start~350ms~350ms
serve --mcp warm38ms~222ms

The daemon keeps OCR engines warm in memory. Every farscry_extract or farscry_diff call hits 38ms consistently on Apple Silicon (CoreML) once the server is running.

Security

The MCP server binds to a Unix socket by default, accessible only to the local user. With --port, it binds to localhost only - never 0.0.0.0. No image data leaves the machine. All processing is local; no API key required.