Railway MCP Server

官方

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

访问 railway.com

文档

Railway MCP Server 是一个 Model Context Protocol (MCP) 服务器，可让你通过自然语言与 Railway 项目及基础设施进行交互。你可以让 IDE 或 AI 助手创建项目、部署模板、管理环境、拉取变量、重新部署服务等。

Railway 提供两种连接方式：

  • 本地 MCP — 通过你机器上的 Railway CLI 运行。推荐用于大多数编码助手工作流，因为它共享 CLI 的身份验证和项目上下文。
  • 远程 MCP — 托管在 mcp.railway.com 的端点。无需本地安装或 CLI；客户端通过浏览器中的 OAuth 进行身份验证。

快速开始

安装 Railway CLI 并通过一条命令配置代理支持——包括技能、MCP 和身份验证。切换选项以定制你想要的设置命令：

如果 CLI 已安装，可跳过引导步骤，直接运行：

railway setup agent          # local MCP
railway setup agent --remote # remote MCP

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

各编辑器配置

如果你更倾向于手动配置编辑器——或者想确切了解 railway mcp install 写入了什么——可使用切换开关在本地 stdio 配置和远程 HTTP 配置之间切换：

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

理解 MCP

Model Context Protocol (MCP) 定义了一套标准，规定了 AI 应用程序（主机）如何通过客户端-服务器架构与外部工具和数据源进行交互。

  • 主机：连接到 MCP 服务器的应用程序，例如 Cursor、VS Code、Claude Code 或 Windsurf。
  • 客户端：主机内部与各个 MCP 服务器保持一对一连接的层。
  • 服务器：独立的程序（如 Railway MCP Server），用于公开管理外部系统的工具和工作流。

本地 Railway MCP Server 将自然语言请求转换为由 Railway CLI 驱动的 CLI 工作流。远程 MCP 服务器运行在 Railway 的基础设施上，并通过 OAuth 进行身份验证。

前提条件

使用示例

  • 创建并部署新应用

    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

可用的 MCP 工具

Railway MCP Server 提供了一组精选工具。你的 AI 助手会根据请求的上下文自动调用这些工具。

本地 MCP

本地服务器通过 Railway CLI 运行，并公开更广泛的 CRUD 工具集：

  • 状态
    • check-railway-status — 验证 CLI 安装和身份验证
  • 项目与服务
    • list-projects、create-project-and-link
    • list-services、link-service
    • deploy — 部署服务
    • deploy-template — 从 Railway 模板库 部署
  • 环境
    • create-environment、link-environment
  • 配置
    • list-variables、set-variables
    • generate-domain
  • 可观测性
    • get-logs

远程 MCP

远程服务器公开了一组聚焦的工具以及一个强大的代理入口点。对于任何复杂操作，可委托给 railway-agent。

  • 账户
    • whoami
  • 项目
    • list-projects、create-project、list-services
  • 部署
    • redeploy
    • accept-deploy — 提交暂存的更改并部署（破坏性操作；客户端会提示确认）
  • 代理
    • railway-agent — 将自然语言请求交给 Railway 的 AI 代理，以执行日志分析、调试和服务配置等多步骤操作

安全注意事项

Railway MCP Server 会代表你运行 CLI 命令或调用 Railway API。破坏性操作已被有意排除在本地服务器的工具列表之外，但你仍应：

  • 审查操作：在批准 LLM 请求的操作之前进行审查，尤其是破坏性操作（redeploy、accept-deploy、railway-agent）。
  • 限制访问：确保只有受信任的用户才能调用 MCP 服务器。
  • 避免生产风险：尽可能将使用限制在非关键环境中。

对于远程服务器，特别需要注意：

  • OAuth 作用域。当你授权时，你可以选择客户端可以访问哪些工作区和项目。令牌是短期有效的，并且可以从你的 Railway 账户设置中撤销。
  • 破坏性操作在协议层面进行了标记。遵循这些提示的客户端会提示确认。
  • 不接受项目令牌。远程 MCP 服务器需要用户身份以用于计费和审计追踪。

功能请求

Railway MCP Server 仍在持续开发中。我们正在积极添加更多工具和功能。如果你有功能请求，请在此 Central Station 帖子中留下反馈。