@blinkpage/mcp

Stdio MCP server for Blinkpage. Lets an LLM client (Claude Desktop, Cursor, Cline) list a user's Blinkpage projects and upload custom components built from TSX or raw HTML.

Tools

| Tool | Purpose | |------|---------| | list_projects | List the user's projects (resources). Returns { id, name }[]. | | upload_component | Build a TSX or HTML component locally and upload it to a project. |

Install

The server is intended to be launched by an MCP client over stdio.

# from a published npm package (once published)
npx -y @blinkpage/mcp

For local development inside the Blinkpage monorepo:

cd blinkpage-mcp-server
npm install
npm run build
node dist/index.js   # waits for stdio frames

Claude Desktop config

Add this to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "blinkpage": {
      "command": "npx",
      "args": ["-y", "@blinkpage/mcp"],
      "env": {
        "BLINKPAGE_TOKEN": "bpat_<your-64-hex-personal-access-token>",
        "BLINKPAGE_API_URL": "https://api.blinkpage.com"
      }
    }
  }
}

Issue a Personal Access Token from the Blinkpage app (Settings → Developer → PATs). The token is shown exactly once at creation time.

Environment variables

| Name | Required | Description | |------|----------|-------------| | BLINKPAGE_TOKEN | yes | Personal access token (bpat_<64hex>). | | BLINKPAGE_API_URL | yes | Base URL of the Blinkpage backend (no trailing slash). | | BLINKPAGE_LOG_LEVEL | no | debug | info | warn | error. Default info. |

If either of the required vars is missing the server logs a single error line to stderr and exits non-zero.

Logging

All logs go to stderr. stdout is reserved for the MCP JSON-RPC transport; writing to it from anywhere in the process would corrupt the connection. Set BLINKPAGE_LOG_LEVEL=debug to see request URLs and tool args.

Scripts

| Script | Purpose | |--------|---------| | npm run build | Compile TS → dist/. | | npm run dev | Same, with --watch. | | npm run start | Run the compiled dist/index.js. | | npm run smoke | Spawn the server, send a tools/list frame, assert both tools register. |