Railway MCP

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

Railway MCP Server 實作了 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，並在單一指令中設定 agent skills、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 應用程式（主機）如何透過用戶端-伺服器架構與外部工具和資料來源互動的標準。

• 主機：例如 Cursor、VS Code、Claude Code 或 Windsurf 等連線至 MCP 伺服器的應用程式。
• 用戶端：主機內負責與個別 MCP 伺服器維持一對一連線的層級。
• 伺服器：獨立的程式（例如 Railway MCP Server），用於公開管理外部系統的工具和工作流程。

Railway MCP 伺服器在 Railway 的基礎架構上執行。railway mcp 指令會透過 stdio 連線至該伺服器，並將您 railway login 工作階段的憑證附加到每個請求。支援 OAuth 的編輯器則會直接連線。

先決條件

連線至 Railway MCP 伺服器需要 Railway 帳戶。預設的 CLI 連線還需要安裝 Railway CLI 和 railway login 工作階段，以便重複使用這些憑證。OAuth 則不需要 CLI。

使用範例

使用描述您希望 agent 產生的 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 Server 公開以下工具。您的 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：提交暫存變更並部署（破壞性；用戶端會提示確認）
• Agent
  • railway-agent：將自然語言請求交給 Railway 的 AI agent，以執行多步驟操作，例如日誌分析、偵錯和服務設定

在本機執行伺服器

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 Server 會代表您呼叫 Railway API。請記住以下幾點：

• CLI 驗證。 railway mcp 指令會讀取並重新整理您的 railway login 憑證。編輯器設定不包含長期有效的 Railway 憑證。
• OAuth 範圍。 使用 OAuth 時，您可以選擇用戶端可以存取的工作區和專案。Token 是短期的，可以從您的 Railway 帳戶設定中撤銷。
• 破壞性操作會在協定層級標記。尊重這些提示的用戶端會提示確認。
• 不接受專案 Token。 伺服器需要使用者身分以進行計費和稽核軌跡。

您仍應：

• 審查 LLM 請求的操作，再予以核准，尤其是破壞性操作（redeploy、accept-deploy、railway-agent，以及本機伺服器的 remove_service、delete_domain、remove_tcp_proxy、 remove_bucket 和 remove_volume）。
• 限制存取，確保只有受信任的使用者可以呼叫 MCP 伺服器。
• 避免生產風險，盡可能將使用限制在非關鍵環境。

功能請求

在 Railway MCP Server Central Station 貼文 上分享功能請求。