Railway MCP

官方

Railway MCP服务器支持通过自然语言与您的Railway项目和基础设施进行交互。您可以指示IDE或AI助手创建项目、部署模板、管理环境、拉取变量、重新部署服务等。

你可以用 Railway MCP 做什么?

  • 创建和部署项目 — 请助手创建新项目或将模板(例如 Postgres 数据库)部署到 Railway。
  • 拉取环境变量 — 获取项目的环境变量,并将其保存到本地 .env 文件。
  • 重新部署服务 — 请助手在指定环境中重新部署特定服务。
  • 调试部署失败问题 — 将多步骤故障排查任务(例如分析崩溃服务的日志)交给 Railway 的 AI 代理。
  • 管理功能标志 — 列出、获取、设置或删除项目的功能标志。
  • 运行云代理任务 — 启动、检查、回复或取消云代理任务,并获取其对话记录。

托管 MCP 服务器

npx add-mcp 'https://mcp.railway.com'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Railway MCP 服务器实现了 Model Context Protocol (MCP)。它让 AI 助手能够创建项目、部署模板、管理环境、拉取变量并重新部署服务。

服务器运行于 mcp.railway.com。可通过以下两种方式之一连接:

  • 通过 CLI(默认)。railway mcp 命令通过 Railway CLI 将编辑器连接到 mcp.railway.com,并复用你的 railway login 凭据,因此无需再次进行身份验证。
  • 使用 OAuth。 支持 OAuth 的编辑器可直接连接到 https://mcp.railway.com,无需使用 CLI。

注意: 通过 CLI 连接需要 CLI 版本为 5.44.0 或更高版本。

快速开始

安装 Railway CLI,并通过一条命令配置代理技能、MCP 和身份验证。 选择选项以生成设置命令:

如果已安装 CLI,可跳过引导步骤并运行:

railway setup agent          # connect through the CLI (default)
railway setup agent --oauth  # connect with OAuth

继续阅读,了解各编辑器的手动配置、可用工具列表和安全注意事项。

各编辑器的配置

如果你更愿意手动配置编辑器,或想查看 railway mcp install 写入的内容,请使用选择器在 CLI 连接、OAuth 和在本地运行服务器之间切换:

railway mcp install 会将 Railway 服务器条目合并到现有配置中,而不会移除其他 MCP 服务器。可随时重新运行以更新配置。

了解 MCP

Model Context Protocol (MCP) 定义了一种标准,用于 AI 应用(主机)通过客户端-服务器架构与外部工具和数据源交互。

  • 主机:连接到 MCP 服务器的应用,例如 Cursor、VS Code、Claude Code 或 Windsurf。
  • 客户端:主机内部负责与各个 MCP 服务器维持一对一连接的层。
  • 服务器:独立程序(例如 Railway MCP 服务器),用于提供管理外部系统的工具和工作流。

Railway MCP 服务器运行在 Railway 的基础设施上。railway mcp 命令通过 stdio 连接到服务器,并将 railway login 会话中的凭据附加到每个请求。支持 OAuth 的编辑器则可直接连接。

前提条件

连接到 Railway MCP 服务器需要拥有 Railway 账户。默认的 CLI 连接还需要安装 Railway CLI,并拥有 railway login 会话,以便复用其中的凭据。OAuth 无需 CLI。

使用示例

使用描述你希望代理在 Railway 上实现什么结果的提示。

  • 创建并部署新应用

    Create a Next.js app in this directory and deploy it to Railway.
    Also assign it a domain.
    
  • 从模板部署

    Deploy a Postgres database
    
  • 拉取环境变量

    Pull environment variables for my project and save them to a .env file
    
  • 调试失败的部署(使用 railway-agent 工具)

    Use the railway agent to figure out why my backend service is
    crashing on deploy
    
  • 重新部署服务

    Redeploy my api service in the production environment
    
  • 管理功能标志

    List feature flags for project <projectId>
    
    Set the checkout-v2 feature flag to true on project <projectId>
    

可用的 MCP 工具

Railway MCP 服务器提供以下工具。AI 助手会根据你的请求选择工具。多步骤操作请使用 railway-agent。

  • 账户
    • whoami
  • 项目
    • list-projects、create-project、list-services
  • 功能标志
    • list-feature-flags、get-feature-flag
    • set-feature-flag、delete-feature-flag(管理员;破坏性删除操作会在协议层标记)
  • 部署
    • redeploy
    • accept-deploy:提交暂存的更改并部署(具有破坏性;客户端会提示确认)
  • 代理
    • railway-agent:将自然语言请求交给 Railway 的 AI 代理,以执行日志分析、调试和服务配置等多步骤操作
  • 云代理任务(参见任务)
    • run-cloud-agent-task:将工作交给云代理(启动新代理会产生费用;客户端会提示确认)
    • check-cloud-agent-task、list-cloud-agent-tasks、get-cloud-agent-transcript
    • respond-cloud-agent-task、cancel-cloud-agent-task
    • list-cloud-agent-models

在本地运行服务器

CLI 还附带一个进程内 MCP 服务器,适用于无法访问 mcp.railway.com 的机器, 例如受出口流量限制的网络。使用 railway mcp local 启动,或使用 railway mcp install --local 为受支持的编辑器写入配置。它使用你的 CLI 凭据直接与 Railway API 通信,在协议层标记具有破坏性的工具,并在要求 confirm: true 前返回预览。

本地服务器提供的工具集与 mcp.railway.com 不同:

  • 账户: whoami
  • 项目和服务: list_workspaces、list_projects、 create_project、list_services、create_service、remove_service、 connect_service_source、disconnect_service_source、link_service、 get_service_config、update_service 和 scale_service
  • 环境和部署: create_environment、link_environment、 environment_status、list_deployments 和 deploy
  • 变量: list_variables、set_variables 和 add_reference_variable
  • 域名: generate_domain、list_domains、domain_status、 update_domain、delete_domain 和 retry_domain_certificate
  • 网络: list_tcp_proxies、get_tcp_proxy、create_tcp_proxy、 remove_tcp_proxy、private_network_status 和 private_network_update
  • 模板: search_templates 和 deploy_template
  • 存储: create_bucket、remove_bucket、create_volume、 update_volume 和 remove_volume
  • 可观测性: get_logs、service_metrics、http_requests、 http_error_rate 和 http_response_time
  • 文档: docs_search 和 docs_fetch

安全注意事项

Railway MCP 服务器会代表你调用 Railway API。请注意以下事项:

  • CLI 身份验证。 railway mcp 命令会读取并刷新你的 railway login 凭据。编辑器配置中不包含长期有效的 Railway 凭据。
  • OAuth 权限范围。 使用 OAuth 时,你可以选择客户端可访问的工作区和项目。令牌有效期较短,可在 Railway 账户设置中撤销。
  • 破坏性操作会在协议层标记。遵循这些提示的客户端会要求确认。
  • 不接受项目令牌。 服务器需要用户身份,以用于账单和审计记录。

你仍应:

  • 检查操作:在批准 LLM 请求的操作前先进行检查,尤其是具有破坏性的操作(redeploy、accept-deploy、railway-agent,以及本地服务器的 remove_service、delete_domain、remove_tcp_proxy、remove_bucket 和 remove_volume)。
  • 限制访问:确保只有受信任的用户才能调用 MCP 服务器。
  • 规避生产风险:尽可能将使用范围限制在非关键环境中。

功能请求

请在 Railway MCP Server Central Station post 上分享功能请求。