Sevalla MCP服务器
    ](https://www.npmjs.com/package/sevalla-mcp) ](https://www.npmjs.com/package/sevalla-mcp)  ](https://nodejs.org/)
A. 模型上下文协议(MCP) 服务器 塞瓦拉 云托管平台。
注: 这是一个社区支持的MCP服务器,不是Sevalla的官方产品。Sevalla提供和维护的官方MCP服务器可在 塞维利亚主办/mcp.
管理您的应用程序、数据库、静态站点、部署、管道等,所有这些都可以通过您的AI助手完成。
快速开始
先决条件
- Node.js v22或更高版本
- 具有API访问权限的Sevalla帐户
- Sevalla API密钥
步骤1:获取Sevalla API密钥
- 登录到您的 塞瓦拉 账户
- 导航到API密钥设置
- 创建或复制API密钥
步骤2:配置MCP客户端
选择与您的MCP客户端匹配的设置:
克劳德桌面(推荐)
添加到您的 claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 窗户: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sevalla": {
"command": "npx",
"args": ["-y", "sevalla-mcp"],
"env": {
"SEVALLA_API_KEY": "your-api-key"
}
}
}
}
克劳德代码(CLI)
添加到您的Claude Code MCP设置中(~/.claude/mcp.json 或项目级别):
{
"mcpServers": {
"sevalla": {
"command": "npx",
"args": ["-y", "sevalla-mcp"],
"env": {
"SEVALLA_API_KEY": "your-api-key"
}
}
}
}
光标
在游标设置中,添加MCP服务器:
{
"mcpServers": {
"sevalla": {
"command": "npx",
"args": ["-y", "sevalla-mcp"],
"env": {
"SEVALLA_API_KEY": "your-api-key"
}
}
}
}
配置参考
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|
SEVALLA_API_KEY | 是 | - | 您的Sevalla API密钥 |
SEVALLA_COMPANY_ID | 否 | - | 列表操作的默认公司ID |
SEVALLA_API_BASE_URL | 没有 | https://api.sevalla.com/v3 | API基本URL(覆盖以使用v2或自定义终结点) |
MCP_TRANSPORT | 没有 | stdio | 运输方式: stdio 或 http |
MCP_SERVER_HOST | 没有 | 127.0.0.1 | 将HTTP服务器绑定到的主机 |
MCP_SERVER_PORT | 没有 | 3000 | HTTP服务器的端口 |
特性
- 118工具 涵盖Sevalla API v3
- 8资源 用于浏览应用程序、数据库、静态站点、管道和用户
- 3个提示 用于指导部署、数据库创建和API密钥设置工作流
- 两种运输方式:stdio(默认)和带StreamableHTTP的HTTP
- 加强安保:头盔、速率限制、CORS、缓存控制(HTTP模式)
- 会话管理:基于LRU的会话缓存,具有空闲超时(HTTP模式)
工具
验证
| 工具 | 描述 | 只读 |
|---|
sevalla.validate | 验证Sevalla API密钥并检查连接 | 是 |
应用程序
| 工具 | 描述 | 只读 |
|---|
sevalla.applications.list | 列出公司的所有申请 | 是 |
sevalla.applications.get | 获取特定应用程序的详细信息 | 是 |
sevalla.applications.create | 创建新应用程序 | 否 |
sevalla.applications.update | 更新应用程序的配置(PATCH) | 否 |
sevalla.applications.delete | 永久删除应用程序 | 否 |
sevalla.applications.activate | 重新激活已暂停的应用程序 | 否 |
sevalla.applications.suspend | 暂停正在运行的应用程序 | 否 |
sevalla.applications.clone | 克隆现有应用程序 | 否 |
部署
| 工具 | 描述 | 只读 |
|---|
sevalla.deployments.list | 列出应用程序的所有部署 | 是 |
sevalla.deployments.get | 获取特定部署的详细信息 | 是 |
sevalla.deployments.start | 触发应用程序的新部署 | 否 |
sevalla.deployments.cancel | 取消正在进行的部署 | 否 |
sevalla.deployments.rollback | 回滚到特定部署 | 否 |
过程
| 工具 | 描述 | 只读 |
|---|
sevalla.processes.list | 列出应用程序的所有进程 | 是 |
sevalla.processes.get | 获取特定流程的详细信息 | 是 |
sevalla.processes.create | 创建新的申请流程 | 否 |
sevalla.processes.update | 更新进程配置(PATCH) | 否 |
sevalla.processes.delete | 删除非web进程 | 否 |
sevalla.processes.trigger-cron | 手动触发cron作业 | 否 |
应用程序域
| 工具 | 描述 | 只读 |
|---|
sevalla.applications.domains.list | 列出应用程序的所有域 | 是 |
sevalla.applications.domains.add | 向应用程序添加自定义域 | 否 |
sevalla.applications.domains.delete | 删除自定义域 | 否 |
sevalla.applications.domains.set-primary | 将域设置为主域 | 否 |
sevalla.applications.domains.refresh-status | 重新检查域验证 | 否 |
应用程序环境变量
| 工具 | 描述 | 只读 |
|---|
sevalla.applications.env-vars.list | 列出所有环境变量 | 是 |
sevalla.applications.env-vars.create | 创建新的环境变量 | 否 |
sevalla.applications.env-vars.update | 更新环境变量(PATCH) | 否 |
sevalla.applications.env-vars.delete | 删除环境变量 | 否 |
应用程序日志
| 工具 | 描述 | 只读 |
|---|
sevalla.applications.logs.access | 获取HTTP访问日志 | 是 |
sevalla.applications.logs.runtime | 获取运行时/标准输出日志 | 是 |
sevalla.applications.logs.deployment | 获取构建/部署日志 | 是 |
网络
| 工具 | 描述 | 只读 |
|---|
sevalla.networking.purge-cache | 清除应用程序的边缘缓存 | 否 |
sevalla.networking.create-internal-connection | 在应用程序或数据库之间创建内部连接 | 否 |
sevalla.networking.toggle-cdn | 为应用程序启用或禁用CDN | 否 |
数据库
| 工具 | 描述 | 只读 |
|---|
sevalla.databases.list | 列出公司的所有数据库 | 是 |
sevalla.databases.get | 获取特定数据库的详细信息 | 是 |
sevalla.databases.create | 创建新数据库 | 否 |
sevalla.databases.update | 更新数据库配置(PATCH) | 否 |
sevalla.databases.delete | 永久删除数据库 | 否 |
sevalla.databases.activate | 重新激活挂起的数据库 | 否 |
sevalla.databases.suspend | 暂停正在运行的数据库 | 否 |
sevalla.databases.reset-password | 重置数据库密码 | 否 |
sevalla.databases.backups.list | 列出数据库的所有备份 | 是 |
sevalla.databases.backups.create | 创建手动备份 | 否 |
sevalla.databases.backups.restore | 从备份还原 | 否 |
静态站点
| 工具 | 描述 | 只读 |
|---|
sevalla.static-sites.list | 列出公司的所有静态站点 | 是 |
sevalla.static-sites.get | 获取特定静态站点的详细信息 | 是 |
sevalla.static-sites.create | 创建新的静态站点 | 否 |
sevalla.static-sites.update | 更新静态站点的配置(PATCH) | 否 |
sevalla.static-sites.delete | 永久删除静态站点 | 否 |
sevalla.static-sites.deploy | 触发静态站点的新部署 | 否 |
sevalla.static-sites.get-deployment | 获取特定静态站点部署的详细信息 | 是 |
sevalla.static-sites.purge-cache | 清除静态站点的边缘缓存 | 否 |
管道
| 工具 | 描述 | 只读 |
|---|
sevalla.pipelines.list | 列出所有部署管道 | 是 |
sevalla.pipelines.get | 获取特定管道的详细信息 | 是 |
sevalla.pipelines.create | 创建新管道 | 否 |
sevalla.pipelines.update | 更新管道(PATCH) | 否 |
sevalla.pipelines.delete | 删除管道 | 否 |
sevalla.pipelines.promote | 在阶段之间推广构建 | 否 |
sevalla.pipelines.stages.create | 创建新的管道阶段 | 否 |
sevalla.pipelines.stages.delete | 删除管道阶段 | 否 |
sevalla.pipelines.enable-preview | 启用预览环境 | 否 |
sevalla.pipelines.disable-preview | 禁用预览环境 | 否 |
负载均衡器
| 工具 | 描述 | 只读 |
|---|
sevalla.load-balancers.list | 列出所有负载平衡器 | 是 |
sevalla.load-balancers.get | 获取负载平衡器详细信息 | 是 |
sevalla.load-balancers.create | 创建负载平衡器 | 否 |
sevalla.load-balancers.update | 更新负载平衡器(PATCH) | 否 |
sevalla.load-balancers.delete | 删除负载平衡器 | 否 |
sevalla.load-balancers.destinations.list | 列出目的地 | 是 |
sevalla.load-balancers.destinations.add | 添加目的地 | 否 |
sevalla.load-balancers.destinations.remove | 删除目标 | 否 |
sevalla.load-balancers.destinations.toggle | 启用/禁用目标 | 否 |
对象存储
| 工具 | 描述 | 只读 |
|---|
sevalla.object-storage.list | 列出所有存储桶 | 是 |
sevalla.object-storage.get | 获取存储桶详细信息 | 是 |
sevalla.object-storage.create | 创建存储桶 | 否 |
sevalla.object-storage.update | 更新存储桶(PATCH) | 否 |
sevalla.object-storage.delete | 删除bucket | 否 |
sevalla.object-storage.cdn.enable | 启用公共CDN | 否 |
sevalla.object-storage.cdn.disable | 禁用公共CDN | 否 |
sevalla.object-storage.objects.list | 列出存储桶对象 | 是 |
sevalla.object-storage.objects.delete | 按关键字删除对象 | 否 |
网络钩子
| 工具 | 描述 | 只读 |
|---|
sevalla.webhooks.list | 列出所有webhooks | 是 |
sevalla.webhooks.get | 获取webhook详细信息 | 是 |
sevalla.webhooks.create | 创建webhook | 否 |
sevalla.webhooks.update | 更新webhook(PATCH) | 否 |
sevalla.webhooks.delete | 删除webhook | 否 |
sevalla.webhooks.toggle | 启用/禁用webhook | 否 |
sevalla.webhooks.roll-secret | 生成新的签名密钥 | 否 |
sevalla.webhooks.event-deliveries.list | 列出事件交付 | 是 |
sevalla.webhooks.event-deliveries.get | 获取交货详细信息 | 是 |
项目
| 工具 | 描述 | 只读 |
|---|
sevalla.projects.list | 列出所有项目 | 是 |
sevalla.projects.get | 获取项目详细信息 | 是 |
sevalla.projects.create | 创建项目 | 否 |
sevalla.projects.update | 更新项目(PATCH) | 否 |
sevalla.projects.delete | 删除项目 | 否 |
sevalla.projects.services.add | 向项目添加服务 | 否 |
sevalla.projects.services.remove | 从项目中删除服务 | 否 |
Docker注册表
| 工具 | 描述 | 只读 |
|---|
sevalla.docker-registries.list | 列出所有注册表凭据 | 是 |
sevalla.docker-registries.get | 获取凭证详细信息 | 是 |
sevalla.docker-registries.create | 创建注册表凭据 | 否 |
sevalla.docker-registries.update | 更新凭据(PATCH) | 否 |
sevalla.docker-registries.delete | 删除凭据 | 否 |
全局环境变量
| 工具 | 描述 | 只读 |
|---|
sevalla.global-env-vars.list | 列出所有全局环境变量 | 是 |
sevalla.global-env-vars.create | 创建全局环境变量 | 否 |
sevalla.global-env-vars.update | 更新全局环境变量(PATCH) | 否 |
sevalla.global-env-vars.delete | 删除全局环境变量 | 否 |
API密钥
| 工具 | 描述 | 只读 |
|---|
sevalla.api-keys.list | 列出所有API密钥 | 是 |
sevalla.api-keys.get | 获取API密钥详细信息 | 是 |
sevalla.api-keys.create | 新建API密钥 | 否 |
sevalla.api-keys.update | 更新API密钥(PATCH) | 否 |
sevalla.api-keys.delete | 删除API密钥 | 否 |
sevalla.api-keys.rotate | 旋转API密钥令牌 | 否 |
sevalla.api-keys.toggle | 启用/禁用API密钥 | 否 |
资源(参考数据)
| 工具 | 描述 | 只读 |
|---|
sevalla.resources.clusters | 列出可用集群/位置 | 是 |
sevalla.resources.database-resource-types | 列出数据库计算机大小 | 是 |
sevalla.resources.process-resource-types | 列出加工机器尺寸 | 是 |
公司
| 工具 | 描述 | 只读 |
|---|
sevalla.company.users | 列出公司的所有用户 | 是 |
资源
| 资源 | URI | 描述 |
|---|
| 应用程序 | sevalla://applications | 列出已配置公司的所有应用程序 |
| 应用程序详细信息 | sevalla://applications/{id} | 获取特定应用程序的详细信息 |
| 数据库 | sevalla://databases | 列出已配置公司的所有数据库 |
| 数据库详细信息 | sevalla://databases/{id} | 获取特定数据库的详细信息 |
| 静态站点 | sevalla://static-sites | 列出已配置公司的所有静态站点 |
| 静态站点详细信息 | sevalla://static-sites/{id} | 获取特定静态站点的详细信息 |
| 管道 | sevalla://pipelines | 列出所有具有阶段的部署管道 |
| 公司用户 | sevalla://company/{id}/users | 列出特定公司的用户 |
提示
| 提示 | 描述 |
|---|
deploy-application | 部署应用程序的指导性工作流程 |
create-database | 创建新数据库的指导性工作流程 |
setup-api-key | 关于配置Sevalla API密钥的说明 |
发展
设置
# Clone the repo
git clone https://github.com/jacob-hartmann/sevalla-mcp.git
cd sevalla-mcp
# Use the Node.js version from .nvmrc
# (macOS/Linux nvm): nvm install && nvm use
# (Windows nvm-windows): nvm install 22 && nvm use 22
nvm install
nvm use
# Install dependencies
pnpm install
# Copy .env.example and configure
cp .env.example .env
# Edit .env with your API key
本地运行
# Development mode (auto-reload)
pnpm dev
# Production build
pnpm build
# Production run
pnpm start
调试
您可以使用 MCP检查员 要调试服务器,请执行以下操作:
# Run from source
pnpm inspect
# Run from built output
pnpm inspect:dist
pnpm inspect 负载 .env 自动通过 dotenv (参见 .env.example).
贡献
欢迎投稿!请参阅 贡献.md 了解如何为这个项目做出贡献的指导方针。
安全
看 安全.md 用于安全策略和报告漏洞。
支持
这是一个“按原样”提供的社区项目 没有保证的支持。参见 支持.md 了解详情。
许可证
麻省理工学院©雅各布·哈特曼