wpaste-mcp

MCP server for Lobster (龙虾笔记) — exposes your wpaste.io personal knowledge base as tools usable from any Model Context Protocol client.

Works in: Cursor, Claude Desktop, Cline, Continue, Goose, Zed, Windsurf, and any other MCP-compatible client.

Tools

| Tool | What it does | |---|---| | publish_document | Save lasting AI output (research, analyses, plans) to your KB. Private by default. | | search_documents | Full-text search your KB | | ask_kb | Question answering over your KB with citations | | get_document | Fetch full Markdown of a document by ID | | append_daily | Append a line to today's daily note (auto-titled YYYY-MM-DD) | | list_workspaces | List your workspaces | | move_to_workspace | File a document into a workspace |

Install

You need a Lobster API token — get one at https://wpaste.io/dashboard/settings. Then add the server to your MCP client.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "wpaste": {
      "command": "npx",
      "args": ["-y", "wpaste-mcp"],
      "env": {
        "WPASTE_TOKEN": "wpaste_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Then in Cursor settings → MCP, enable wpaste. Use it in chat: "search my KB for React Server Components notes".

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "wpaste": {
      "command": "npx",
      "args": ["-y", "wpaste-mcp"],
      "env": {
        "WPASTE_TOKEN": "wpaste_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop.

Cline (VSCode)

In VSCode settings, edit cline.mcpServers:

{
  "wpaste": {
    "command": "npx",
    "args": ["-y", "wpaste-mcp"],
    "env": { "WPASTE_TOKEN": "wpaste_xxx" }
  }
}

Continue.dev

~/.continue/config.json:

{
  "mcpServers": {
    "wpaste": {
      "command": "npx",
      "args": ["-y", "wpaste-mcp"],
      "env": { "WPASTE_TOKEN": "wpaste_xxx" }
    }
  }
}

Goose

~/.config/goose/config.yaml:

extensions:
  wpaste:
    type: stdio
    cmd: npx
    args: ["-y", "wpaste-mcp"]
    envs:
      WPASTE_TOKEN: wpaste_xxx

Environment variables

| Var | Default | Notes | |---|---|---| | WPASTE_TOKEN | (required) | Your Lobster API token (wpaste_…) | | WPASTE_SERVER | https://wpaste.io | Override for self-hosted instances | | HTTPS_PROXY / HTTP_PROXY / ALL_PROXY | — | HTTP proxy honored for outbound calls |

Suggested system prompt

Add this to your AI's rules / system prompt to encourage knowledge-base usage:

You have access to my Lobster knowledge base via the wpaste MCP server.

• Before writing a long analysis, call search_documents to check for prior work.
• When you finish lasting content (research, plans, code reviews), call publish_document to save it. Default to private.
• For short progress logs, call append_daily instead of creating a new doc.

Development

cd cli/wpaste-mcp
npm install
npm run build           # tsc → dist/
node scripts/smoke.mjs  # spawn server, list tools (no token needed)
node scripts/e2e.mjs    # call list_workspaces + search against production (uses ~/.wpaste/config.json or $WPASTE_TOKEN)

License

MIT