使用说明

Sevalla MCP服务器

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 了解详情。