@infrastellar/tesseract-mcp

Local MCP server that connects Claude Code, Cursor, and other MCP clients to Tesseract running in the cloud.

Quick Start

1. Configure your MCP client

Claude Code:

claude mcp add tesseract -- npx @infrastellar/tesseract-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "tesseract": {
      "command": "npx",
      "args": ["@infrastellar/tesseract-mcp"]
    }
  }
}

Cursor / other MCP clients:

{
  "mcpServers": {
    "tesseract": {
      "command": "npx",
      "args": ["tesseract-mcp"]
    }
  }
}

2. Authenticate

On the first use, call the login tool from your MCP client. This opens a browser for pairing with your Tesseract account. Credentials are saved to ~/.tesseract/credentials.json.

How It Works

The proxy speaks MCP over stdio to your client and forwards each request as an RPC message over WebSocket to the cloud Tesseract renderer.

• Connect-on-demand: WebSocket opens on the first MCP request
• Idle timeout: Connection closes after 60 seconds of inactivity
• Auto-reconnect: If the connection drops while a request is in flight, the proxy reconnects (up to 3 attempts)

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | TESSERACT_API_URL | Cloud API base URL | https://cloud.tesseract.ing | | TESSERACT_CONFIG_DIR | Config directory | ~/.tesseract |