@dreamoasis/mcp

DreamLand MCP server — commit your local build to DreamLand as a draft, straight from your AI coding agent. You then activate the draft into a version on the DreamLand website.

Status: first version. Tools: dreamland_create_project, dreamland_commit_draft, dreamland_list_projects, dreamland_link_workdir_with_project, dreamland_verify_mcp_connection. Only stdio transport; only Cursor is wired for one-click install so far.

Configuration

The server reads two environment variables (the onboarding deeplink sets both for you):

| Env | Required | Meaning | |-----|----------|---------| | DREAMLAND_API_KEY | yes | Your DreamLand API key (dl_...), generated in DreamLand settings. Sent as X-API-Key. | | DREAMLAND_API_BASE | no | DreamLand backend base URL. Defaults to http://localhost:8080 for local dev. |

Example MCP config entry:

{
  "command": "npx",
  "args": ["-y", "@dreamoasis/mcp"],
  "env": {
    "DREAMLAND_API_KEY": "dl_...",
    "DREAMLAND_API_BASE": "https://your-dreamland-origin"
  }
}

Develop

npm install
npm test        # vitest
npm run build   # tsc -> dist/

This package is developed inside the DreamLand monorepo (mcp/) and mirrored to a standalone repo for distribution via git subtree. The monorepo copy is the only place to edit it.