@uigraph/mcp

Connect Cursor to UIGraph MCP with a local stdio proxy and Cognito auth.

1. Add to Cursor

Open your MCP config and add:

{
  "servers": {
    "uigraph": {
      "command": "uigraph-mcp"
    }
  }
}

Or run:

npx @uigraph/mcp init cursor

init cursor installs @uigraph/mcp globally with npm i -g @uigraph/mcp only if uigraph-mcp is not already available on PATH.

2. Login once

Run browser login (via dev.uigraph.app) and store credentials in your OS keychain:

npx @uigraph/mcp auth login

No environment setup is required for default dev usage.

3. Start using it

• Open Cursor
• The MCP proxy starts automatically
• Use UIGraph tools directly in chat

Auth commands

npx @uigraph/mcp auth status
npx @uigraph/mcp auth logout

Legacy fallback (temporary)

If keychain auth is not available yet, the proxy still accepts env tokens:

UIGRAPH_TOKEN=your_token_here
UIGRAPH_API_KEY=your_api_key_here

How it works

Cursor (stdio)
   ↓
@uigraph/mcp (this proxy)
   ↓
HTTPS (Authorization: Bearer <access token>)
   ↓
Remote MCP Server

The proxy:

• Reads JSON-RPC messages from stdin
• Opens frontend login and receives local callback
• Reads and refreshes Cognito tokens from keychain
• Forwards requests to the remote server
• Returns responses back to stdout

It does not implement tools or business logic.