Wavedash

Wavedash MCP

用于读取 Wavedash 文档、SDK 指南、引擎设置和发布检查清单的远程 MCP 服务。

此服务有意不要求身份验证。它只读取 https://docs.wavedash.com 上的公开文档，不会访问用户账户、游戏、构建、本地文件、API 密钥或 Wavedash 私有数据。

工具

四种相互独立的工具，让客户端几乎无需在功能重叠的选项之间做选择：

• wavedash_implementation_planner - 根据用户的目标、引擎和所需功能，规划并指导 Wavedash 集成。stage 参数可选择 plan（架构和阅读顺序）、setup（CLI 安装、登录、SDK 初始化、wavedash.toml、本地测试）、features（所需功能的 SDK 参考）或 deploy（上传和发布检查清单）。以文本和结构化输出的形式返回有序步骤、范围界限以及相关文档页面及其内容。
• search_wavedash_docs - 搜索 Wavedash 官方文档。
• get_wavedash_doc - 以 Markdown 格式获取文档页面。
• validate_wavedash_config - 验证 wavedash.toml 文本，包括从聊天中粘贴的单行或代码围栏格式的输入。

引擎、主题和功能页面会在运行时根据文档站点的搜索索引解析，因此无需在此处更改即可支持新的文档页面。

本地运行

npm install
npm start

MCP 端点：

http://localhost:3000/mcp

健康状态/信息端点：

http://localhost:3000/

Docker

docker build -t wavedash-mcp .
docker run --rm -p 3000:3000 wavedash-mcp

Cloudflare Workers

Worker 入口文件为 src/worker.js，由 wrangler.toml 配置。 它通过 /mcp 提供无状态的 Streamable HTTP MCP 端点。

Deploy MCP to Production GitHub Actions 工作流会在推送到 main 时自动部署，但仅限更改了 MCP 源码、软件包依赖项、wrangler.toml、根目录下的 package.json 或部署工作流本身。文档和技能的更改不会触发部署。仍可手动运行工作流。

本地 Worker 开发：

npm run worker:dev

不发布即可验证 Worker 包：

npm run deploy:dry-run

部署：

npm run deploy

在仓库根目录中，运行：

npm run mcp:deploy

生产环境的 MCP 端点：

https://mcp.wavedash.com/mcp

wrangler.toml 将 mcp.wavedash.com 声明为 Cloudflare Workers 自定义域名。如果 wavedash.com 位于同一 Cloudflare 账户中，Wrangler 可以绑定该主机名，无需手动添加 DNS 记录。

远程客户端测试

健康状态/信息端点：

https://mcp.wavedash.com/

Cloudflare AI Playground 可以直接测试已部署的端点：

https://mcp.wavedash.com/mcp

支持 Streamable HTTP 的远程 MCP 客户端可以直接连接到同一端点。

对于 Claude Desktop 或其他需要使用 stdio 的本地 MCP 客户端，请使用 mcp-remote：

{
  "mcpServers": {
    "wavedash": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.wavedash.com/mcp"]
    }
  }
}

配置

环境变量	默认值	说明
PORT	3000	HTTP 服务端口。
WAVEDASH_DOCS_BASE_URL	https://docs.wavedash.com	公开文档源站。
WAVEDASH_MCP_FETCH_TIMEOUT_MS	10000	文档请求的获取超时时间。
WAVEDASH_MCP_SEARCH_CACHE_MS	300000	搜索索引缓存 TTL。

v0 / Lovable / Bolt 的范围

将此服务用作无需身份验证的 Wavedash MCP 列表。它可以在生成浏览器游戏时为 Agent 提供指导，但无法上传或发布构建。

对于需要身份验证的步骤，MCP 应指导用户或宿主 Agent 使用：

• Wavedash CLI 安装文档：https://docs.wavedash.com/cli/installation
• Wavedash CLI 浏览器登录：wavedash auth login
• CI/API 令牌登录：wavedash auth login --token ... 或 WAVEDASH_TOKEN
• Developer Portal 手动上传/发布：https://wavedash.com/dev-portal

Wavedash CLI 是一款命令行应用，用于登录、初始化 wavedash.toml、本地测试、上传构建，以及从项目文件夹发布。对于不想使用终端命令的用户，请引导他们改用 Developer Portal。

请勿将 API 密钥、会话 Cookie 或私有凭据作为 MCP 工具参数传入。

创建游戏、上传构建或发布等需要身份验证的工具，应放在独立的身份验证 MCP 接口中，并由 Wavedash OAuth 或范围受限的 Agent 授权提供支持。