souvea-mcp

Stdio bridge for Claude Desktop → Souvéa personal-mcp.

Claude Desktop only accepts local MCP servers (command + args). This package reads JSON-RPC from stdin, posts it to Souvéa with your Continuity PAT, and writes the response to stdout.

Claude Desktop config

{
  "mcpServers": {
    "souvea": {
      "command": "npx",
      "args": ["-y", "souvea-mcp"],
      "env": {
        "SOUVEA_PAT": "souvea_pat_..."
      }
    }
  }
}

Needs Node.js 18+. Fully quit and reopen Claude Desktop after saving.

Environment

| Variable | Required | Description | |----------|----------|-------------| | SOUVEA_PAT | yes* | Continuity / Local IDE PAT (souvea_pat_…) | | SOUVEA_OAT | alt | OAuth access token (souvea_oat_…) | | SOUVEA_TOKEN | alt | Either PAT or OAT | | SOUVEA_MCP_URL | no | Override MCP URL (default: production personal-mcp) |

* One of SOUVEA_PAT, SOUVEA_OAT, or SOUVEA_TOKEN.

Cursor / Codex

Do not use this bridge. Cursor accepts url + headers directly; Codex uses Streamable HTTP with a static Authorization header. See Account → Continuity in Souvéa.

Validate

1. Souvéa tools appear (not only “connected”).
2. Call get_profile_summary.
3. Continuity write tokens should also list ingest_turn / ingest_conversation.

Develop

cd packages/souvea-mcp
npm test

Publish

cd packages/souvea-mcp
npm login   # once
npm publish --access public

Until the package is on npm, Claude Desktop can run the local binary:

{
  "mcpServers": {
    "souvea": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/souvea/packages/souvea-mcp/bin/souvea-mcp.js"],
      "env": {
        "SOUVEA_PAT": "souvea_pat_..."
      }
    }
  }
}