Railway MCP

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

Railway MCP 服务器实现了 模型上下文协议（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

模型上下文协议（MCP） 定义了 AI 应用程序（主机）如何通过客户端-服务器架构与外部工具和数据源交互的标准。

• 主机：如 Cursor、VS Code、Claude Code 或 Windsurf 等连接到 MCP 服务器的应用程序。
• 客户端：主机内与各个 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 代理，用于日志分析、调试和服务配置等多步骤操作

本地运行服务器

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 服务器 Central Station 帖子 上分享功能请求。