@sota-io/mcp

用于 sota.io 的 MCP 服务器 — 通过 AI 代理部署 Web 应用。

两种传输方式

自 v1.4.0 起，本包提供两种传输方式：

• sota-mcp（stdio，默认）— 适用于 Claude Code、Cursor、Windsurf 以及任何生成本地进程的 MCP 客户端。通过环境变量传入您的 SOTA_API_KEY。

• sota-mcp-http（可流式 HTTP）— 用于自托管驱动 mcp.sota.io 的远程端点（由 Claude Desktop 和 Claude.ai 网页使用）。读取 SUPABASE_JWT_SECRET、DATABASE_URL 等 — 大多数用户不需要此方式；如果您想自行托管，它与 mcp.sota.io 上运行的代码相同。

大多数用户需要 stdio 传输方式。

Related MCP server: AppsAI MCP Server

一键安装到 Claude Desktop / Claude.ai 网页

如果您使用 Claude Desktop 或 Claude.ai（Pro / Max / Team / Enterprise 计划），最简单的安装不是这个 npm 包 — 而是托管在 mcp.sota.io 的远程端点。点击此处：

添加到 Claude →

OAuth 处理身份验证。新用户可以通过 create_account 工具完全在 Claude 内部注册 — 无需切换浏览器标签页。

参见 https://sota.io/docs/integrations/claude。

快速开始（stdio — Claude Code、Cursor、Windsurf 等）

1. 从 sota.io/dashboard/settings 获取 API 密钥

2. 配置您的 IDE

3. 向您的 AI 提问："将我的应用部署到 sota.io"

安装

无需安装 — 直接使用 npx 运行：

npx -y @sota-io/mcp

或全局安装：

npm install -g @sota-io/mcp
sota-mcp

配置

Claude Code

CLI 方法：

claude mcp add sota -- npx -y @sota-io/mcp

然后在 shell 环境中设置您的 API 密钥：

export SOTA_API_KEY=sota_your_api_key_here

手动 JSON（.claude/settings.json）：

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Claude Desktop

编辑 claude_desktop_config.json：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Cursor

在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

工具

deploy

将应用部署到 sota.io。创建指定目录的 tar.gz 归档并上传。

"Deploy my app in the current directory to sota.io"

get-logs

获取部署的构建和运行时日志。如果未提供 deployment_id，则返回最新部署的日志。

"Show me the build logs for my sota.io project"

set-env

为项目设置环境变量。

"Set DATABASE_URL on my project to postgres://localhost/mydb"

get-env

列出项目的环境变量。

"Show all environment variables for my project"

rollback

将项目回滚到之前的部署。此操作会交换容器镜像而无需重新构建。

"Roll back my app to the previous version"

get-status

获取项目的当前部署状态，包括 URL 和最近的部署历史。

"What's the status of my sota.io deployment?"

list-projects

列出您 sota.io 账户上的所有项目。

无需参数。

"List my sota.io projects"

create-project

在 sota.io 上创建新项目。项目 slug 从名称自动生成（小写、连字符、最多 63 个字符），并用作子域名（{slug}.sota.io）。例如，"My API" 变为 my-api.sota.io。

"Create a new sota.io project called my-api"

delete-project

从 sota.io 删除项目及其所有部署。此操作不可逆。

"Delete my sota.io project abc123"

add-domain

为项目添加自定义域名。返回指向该域名的 DNS 说明。

"Add example.com as a custom domain to my project"

list-domains

列出项目的所有自定义域名。

"Show all custom domains for my project"

get-domain

获取域名详情，包括 DNS 验证状态和 SSL 状态。

"Check the DNS status of my custom domain"

remove-domain

从项目移除自定义域名。

"Remove the custom domain from my project"

环境变量

故障排除

"npx: command not found"

问题： 您的 IDE 未继承加载 nvm/fnm 的 shell PATH。

修复： 使用 npx 的绝对路径。通过以下命令找到它：

which npx
# Example output: /Users/you/.nvm/versions/node/v22.0.0/bin/npx

然后更新您的 MCP 配置以使用绝对路径：

{
  "mcpServers": {
    "sota": {
      "command": "/Users/you/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

"SOTA_API_KEY environment variable is required"

问题： 未在 MCP 配置中设置 API 密钥。

修复： 在 MCP 服务器配置中添加 env 块。Shell 环境变量不会自动传递给 MCP 服务器 — 配置中的 env 块是必需的：

{
  "env": {
    "SOTA_API_KEY": "sota_your_api_key_here"
  }
}

连接被拒绝或超时错误

问题： 网络问题或 API URL 错误。

修复： 检查您的互联网连接。如果您使用自定义 API URL，请验证 SOTA_API_URL 设置正确。默认值为 https://api.sota.io。

许可证

MIT

链接

• 网站

• 文档

• 控制面板

• 问题反馈