Railway MCP

官方

Railway MCP Server 讓您能透過自然語言與 Railway 專案及基礎設施互動。您可以指示 IDE 或 AI 助手建立專案、部署模板、管理環境、提取變數、重新部署服務等。

造訪 railway.com

你可以用 Railway MCP 做什麼？

建立並部署應用程式 — 透過 create_project 和 generate_domain 要求建立 Next.js 應用程式、部署它，並指派網域。
從範本部署 — 使用 search_templates 和 deploy_template 搜尋並部署現成範本，例如 Postgres。
管理環境變數 — 使用 list_variables 和 set_variables 將變數拉入 .env 檔案或進行設定。
重新部署服務 — 使用 redeploy 工具在特定環境中觸發服務的重新部署。
除錯失敗的部署 — 將自然語言的除錯請求交給 railway-agent 來診斷當機問題。
管理功能旗標 — 透過 list-feature-flags 和 set-feature-flag 列出、取得或設定專案上的功能旗標。

文件

Railway MCP Server 實作了 Model Context Protocol (MCP)。它讓 AI 助手可以建立專案、部署範本、管理環境、提取變數，以及重新部署服務。

Railway 提供兩種 MCP 伺服器：

Local MCP 透過您機器上的 Railway CLI 執行，並使用本機 CLI 內容。
Remote MCP 在 mcp.railway.com 執行。直接使用 OAuth 連線，或執行 railway mcp proxy 以重複使用您 railway login 工作階段的憑證。

快速開始

安裝 Railway CLI，並透過單一指令設定 agent skills、MCP 和驗證。選擇選項以產生設定指令：

如果 CLI 已安裝，請跳過引導程序並執行：

railway setup agent                  # Local MCP
railway setup agent --remote         # Remote MCP through the CLI proxy
railway setup agent --remote --oauth # Remote MCP with OAuth

繼續閱讀以了解各編輯器的手動設定、可用的工具清單，以及安全性考量。

各編輯器設定

如果您偏好手動設定編輯器，或想檢查 railway mcp install 寫入了什麼，請使用選擇器在本機 stdio、透過 CLI proxy 的 Remote MCP，以及使用 OAuth 的 Remote MCP 之間切換：

railway mcp install 會將 Railway 伺服器項目合併到現有設定中，而不會移除其他 MCP 伺服器。隨時重新執行即可更新。

了解 MCP

Model Context Protocol (MCP) 定義了 AI 應用程式（主機）如何透過用戶端-伺服器架構與外部工具和資料來源互動的標準。

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

Local MCP 伺服器會將自然語言請求轉換為由 Railway CLI 驅動的 CLI 工作流程。Remote MCP 在 Railway 的基礎架構上執行並支援 OAuth。CLI proxy 提供另一種連線路徑，將您 railway login 工作階段的憑證傳遞給 Remote MCP。

先決條件

伺服器和驗證方法決定了您需要哪些本機工具和憑證。

Local MCP 需要已安裝並完成驗證的 Railway CLI。
Remote MCP 需要 Railway 帳戶。直接 OAuth 不需要 CLI。CLI proxy 需要已安裝的 CLI 和 railway login 工作階段，以便重複使用這些憑證。

使用範例

使用描述您希望 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 助手會根據您的請求選擇工具。

Local MCP

Local MCP 透過 Railway CLI 執行，並公開以下工具：

帳戶： 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

Remote MCP

Remote MCP 公開以下工具。使用 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，以進行日誌分析、偵錯和服務設定等多步驟操作

安全性考量

Railway MCP Server 會代表您執行 CLI 指令或呼叫 Railway API。Local MCP 會以協定層級提示標記破壞性工具，並在要求 confirm: true 之前先傳回預覽。您仍應：

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

對於 Remote MCP：

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

功能請求

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