capawesome

Capawesome MCP 服务

Capawesome 的官方 MCP 服务。它为 AI 助手提供最新的 Capawesome 文档，包括插件、Capawesome Cloud、Capawesome Insiders 和 CLI；如果提供 API 令牌，还可访问 Capawesome Cloud 管理 API，以管理应用、频道、构建、部署等。

由 Capawesome 维护。

端点

该服务已托管，可随时使用：

https://mcp.capawesome.io/mcp

文档工具无需账户或令牌。只有请求携带 API 令牌时，才能使用 Capawesome Cloud 工具——请参阅身份验证。

安装

Claude Code

使用文档工具无需令牌：

claude mcp add --transport http capawesome https://mcp.capawesome.io/mcp

若要添加 Capawesome Cloud 工具，请将 API 令牌作为 bearer header 传递，并选择工具集：

claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp?toolsets=all" \
  --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop / Claude.ai

前往设置 → 连接器 → 添加自定义连接器，并输入：

• 名称：Capawesome
• URL：https://mcp.capawesome.io/mcp

Cursor

或者在项目中添加 .cursor/mcp.json：

{
  "mcpServers": {
    "capawesome": {
      "url": "https://mcp.capawesome.io/mcp"
    }
  }
}

VS Code

在 VS Code 中安装

或者在项目中添加 .vscode/mcp.json：

{
  "servers": {
    "capawesome": {
      "type": "http",
      "url": "https://mcp.capawesome.io/mcp"
    }
  }
}

Windsurf

将服务添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "capawesome": {
      "serverUrl": "https://mcp.capawesome.io/mcp"
    }
  }
}

Zed

将服务添加到 Zed 的 settings.json：

{
  "context_servers": {
    "capawesome": {
      "url": "https://mcp.capawesome.io/mcp"
    }
  }
}

通过 npx 使用任意客户端

无法通过 HTTP 连接远程服务的客户端，可以运行此软件包；它会将 stdio 代理到托管服务：

{
  "mcpServers": {
    "capawesome": {
      "command": "npx",
      "args": ["-y", "@capawesome/mcp"],
      "env": {
        "CAPAWESOME_TOKEN": "your-token"
      }
    }
  }
}

需要 Node.js 22 或更高版本。省略 env 即可仅使用文档工具。

身份验证

在 Capawesome Cloud Console 中创建 API 令牌，并将其传递给服务。

通过 HTTP 连接时，请将令牌作为 Authorization: Bearer <token> header 发送。运行此软件包时，请设置 CAPAWESOME_TOKEN 环境变量，代理会为你发送 header。

不提供令牌时，只会注册文档工具——Capawesome Cloud 工具不会启用，而不只是被隐藏。

配置

以下环境变量用于配置代理。它们仅适用于此软件包；通过 HTTP 连接时，请使用对应的 header 和查询参数。

变量	用途
CAPAWESOME_TOKEN	API 令牌，以 Authorization: Bearer 形式发送。可选；不提供时仅可使用文档工具。
CAPAWESOME_MCP_TOOLSETS	以逗号分隔的工具集，用于注册并通过 ?toolsets= 发送。使用 cloud 可启用所有 Capawesome Cloud 工具集，使用 all 可启用全部工具。默认为 docs。
CAPAWESOME_MCP_READONLY	设置为 true 可跳过所有会写入或删除内容的工具，并通过 ?readonly=true 发送。
CAPAWESOME_MCP_URL	覆盖端点。仅用于开发。

工具

该服务提供文档工具（search_docs、get_doc_page、list_blog_posts），以及用于 Capawesome Cloud 管理 API 的 cloud_* 工具；这些工具按工具集分组。

完整的工具和工具集参考，请参阅 MCP 文档。

速率限制

该端点的限制为每个 IP 每分钟 100 个请求。超出限制的请求会收到 429 Too Many Requests 响应；请稍等片刻后重试。

隐私

你的 IP 地址仅用于速率限制。查询和工具参数不会被存储，除 Cloudflare 的标准边缘日志外不会被记录，也绝不会用于训练。你的 API token 用于代表你向 Capawesome Cloud API 进行身份验证，服务器不会存储该 token。详情请参阅隐私政策。

相关项目

• Capacitor MCP Server — 面向 Capacitor 文档、插件列表和博客的非官方 MCP 服务。
• Ionic Framework MCP Server — 面向 Ionic Framework 文档、组件和用法示例的非官方 MCP 服务。
• Capawesome Cloud Live Updates — 向应用发布 JavaScript、HTML 和 CSS 更改，无需经过应用商店审核。
• Capawesome Cloud Native Builds — 在云端构建原生 iOS 和 Android 应用，无需 Mac。
• Capawesome Cloud App Store Publishing — 将构建版本提交到 Apple App Store 和 Google Play Store。

开发

npm install
npm run build
npm test

将 CAPAWESOME_MCP_URL 设置为本地服务地址，而非托管服务：

CAPAWESOME_MCP_URL=http://localhost:8787/mcp node dist/index.js

发布

发布由 release-please 管理。合并其发布拉取请求后，会为版本创建标签、将软件包发布到 npm，然后将 server.json 发布到 MCP Registry。release-please 会同时更新 server.json 和 package.json 中的版本，因此无需手动编辑。若要手动发布到注册表，请安装 mcp-publisher，使用密码管理器中的 Ed25519 私钥运行 mcp-publisher login dns --domain=capawesome.io --private-key=<key>，然后运行 mcp-publisher publish。

许可证

请参阅 LICENSE。