使用说明
@ sota-io/mcp
MCP服务器 sota.io --通过AI代理部署web应用程序。
两次运输
自v1.4.0版本起，此软件包开始发货 两次运输:
sota-mcp（stdio，默认）--适用于克劳德代码、光标、风帆和任何 生成本地进程的MCP客户端。传递您的SOTA_API_KEY通过 env var。sota-mcp-http（流式HTTP）--用于远程端点的自托管 这种力量mcp.sota.io（由Claude Desktop和Claude.ai网站使用）。倒像SUPABASE_JWT_SECRET,DATABASE_URL等等。——大多数用户不需要这个； 这是在上面运行的相同代码mcp.sota.io如果你想举办自己的。
大多数用户都希望使用stdio传输。
一键安装克劳德桌面/Claude.ai网站
如果您使用Claude Desktop或Claude.ai（Pro/Max/Team/Enterprise计划），
最简单的安装是 不 这个npm包——它是托管的远程
端点位于 mcp.sota.io。单击此处：
OAuth处理身份验证。新用户可以通过以下方式在Claude内部完全注册
create_account 工具--无浏览器选项卡开关。
看 https://sota.io/docs/integrations/claude.
快速入门（stdio——克劳德代码、光标、风帆等）
- 从获取API密钥 sota.io/仪表板/设置
- 配置IDE
- 问你的AI： “将我的应用程序部署到sota.io”
安装
无需安装 --直接使用npx运行：
npx -y @sota-io/mcp
或全局安装：
npm install -g @sota-io/mcp
sota-mcp
配置
克劳德代码
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_config.json:
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%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/mcp.json 在项目根目录中：
{
"mcpServers": {
"sota": {
"command": "npx",
"args": ["-y", "@sota-io/mcp"],
"env": {
"SOTA_API_KEY": "sota_your_api_key_here"
}
}
}
}
帆板运动
编辑 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"sota": {
"command": "npx",
"args": ["-y", "@sota-io/mcp"],
"env": {
"SOTA_API_KEY": "sota_your_api_key_here"
}
}
}
}
工具
| 工具 | 说明 | 参数 |
|---|---|---|
deploy |
部署应用程序 | project_id, directory? |
get-logs |
获取构建/运行时日志 | project_id, deployment_id? |
set-env |
设置环境变量 | project_id, key, value |
get-env |
列出环境变量 | project_id |
rollback |
回滚到以前的部署 | project_id |
get-status |
获取部署状态 | project_id |
list-projects |
列出所有项目 | （无） |
create-project |
创建新项目 | name |
delete-project |
永久删除项目 | project_id |
add-domain |
将自定义域添加到项目中 | project_id, domain |
list-domains |
列出自定义域 | project_id |
get-domain |
获取域详细信息和DNS状态 | project_id, domain_id |
remove-domain |
删除自定义域 | project_id, domain_id |
deploy
将应用程序部署到sota.io。创建指定目录的tar.gz存档并上传。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 要部署到的项目ID |
directory |
string | 否 | 要部署的目录（默认为当前工作目录） |
"Deploy my app in the current directory to sota.io"
get-logs
获取部署的构建和运行时日志。如果没有提供deployment_id，则返回最新部署的日志。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 要获取日志的项目ID |
deployment_id |
string | 否 | 特定部署ID（默认为最新） |
"Show me the build logs for my sota.io project"
set-env
为项目设置环境变量。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 项目ID |
key |
string | 是 | 环境变量名（例如DATABASE_URL） |
value |
string | 是 | 环境变量值 |
"Set DATABASE_URL on my project to postgres://localhost/mydb"
get-env
列出项目的环境变量。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 项目ID |
"Show all environment variables for my project"
rollback
将项目回滚到之前的部署。这将交换容器映像，而无需重新生成。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 要回滚的项目ID |
"Roll back my app to the previous version"
get-status
获取项目的当前部署状态，包括URL和最近的部署历史记录。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 要检查状态的项目ID |
"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).例如，“我的API”变成 my-api.sota.io.
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name |
string | 是 | 新项目的名称 |
"Create a new sota.io project called my-api"
delete-project
从sota.io中删除项目及其所有部署。此操作是永久性的。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 要删除的项目ID |
"Delete my sota.io project abc123"
add-domain
将自定义域添加到项目中。返回指向域的DNS指令。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 项目ID |
domain |
string | 是 | 域名（例如“example.com”或“app.example.com”） |
"Add example.com as a custom domain to my project"
list-domains
列出项目的所有自定义域。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 项目ID |
"Show all custom domains for my project"
get-domain
获取域详细信息，包括DNS验证状态和SSL状态。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 项目ID |
domain_id |
string | 是 | 域ID |
"Check the DNS status of my custom domain"
remove-domain
从项目中删除自定义域。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id |
string | 是 | 项目ID |
domain_id |
string | 是 | 要删除的域ID |
"Remove the custom domain from my project"
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
SOTA_API_KEY |
是 | - | neneneba API密钥，带有 sota_ 前缀。创建时间 sota.io/仪表板/设置 |
SOTA_API_URL |
没有 | https://api.sota.io |
API基本URL |
故障排除
“npx:找不到命令”
问题： 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环境变量是必需的”
问题： API密钥未在MCP配置中设置。
修复： 添加 env 阻止您的MCP服务器配置。Shell环境变量确实如此 不 自动传递给MCP服务器 env 配置中的块是必需的：
{
"env": {
"SOTA_API_KEY": "sota_your_api_key_here"
}
}
连接被拒绝或超时错误
问题： 网络问题或错误的API URL。
修复： 检查您的互联网连接。如果您正在使用自定义API URL，请验证 SOTA_API_URL 设置正确。默认值为 https://api.sota.io.
许可证
麻省理工学院
