Railway MCP
ทางการเซิร์ฟเวอร์ Railway MCP ช่วยให้คุณสามารถโต้ตอบกับโปรเจกต์และโครงสร้างพื้นฐานของ Railway ได้ด้วยภาษาธรรมชาติ สั่งให้ IDE หรือผู้ช่วย AI ของคุณสร้างโปรเจกต์ ปรับใช้เทมเพลต จัดการสภาพแวดล้อม ดึงตัวแปร ปรับใช้บริการใหม่ และอื่นๆ อีกมากมาย
คุณทำอะไรได้บ้างด้วย Railway MCP?
- สร้างและ deploy โปรเจกต์ — ขอให้สร้างโปรเจกต์ใหม่หรือ deploy เทมเพลตอย่าง Postgres ด้วย
create-projectและdeploy_template - จัดการ environment variables — ดึงตัวแปรไปยังไฟล์
.envหรือตั้งค่าตาม environment แต่ละตัวโดยใช้list_variablesและset_variables - redeploy หรือดีบักบริการ — เรียกใช้การ redeploy ด้วย
redeployหรือใช้railway-agentเพื่อวินิจฉัยว่าทำไมบริการถึง crash - ควบคุม feature flags — ดูรายการ ดูรายละเอียด หรือสลับ flags อย่าง
checkout-v2ผ่านlist-feature-flagsและset-feature-flag - จัดการโดเมนและเครือข่าย — สร้างโดเมนด้วย
generate_domainหรือจัดการ TCP proxies และ private networks - ปรับขนาดและกำหนดค่าบริการ — อัปเดตการกำหนดค่าบริการหรือปรับขนาด instances โดยใช้
update_serviceและscale_service
เซิร์ฟเวอร์ MCP แบบโฮสต์
npx add-mcp 'https://mcp.railway.com'ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ
เอกสาร
Railway MCP Server ใช้ Model Context Protocol (MCP) ช่วยให้ผู้ช่วย AI สามารถสร้างโปรเจกต์ ปรับใช้เทมเพลต จัดการสภาพแวดล้อม ดึงตัวแปร และปรับใช้บริการใหม่ได้
เซิร์ฟเวอร์ทำงานที่ mcp.railway.com เชื่อมต่อได้สองวิธี:
- ผ่าน CLI (ค่าเริ่มต้น) คำสั่ง
railway mcpเชื่อมต่อโปรแกรมแก้ไขของคุณกับmcp.railway.comผ่าน Railway CLI โดยใช้ข้อมูลรับรอง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 (โฮสต์) สามารถโต้ตอบกับเครื่องมือภายนอกและแหล่งข้อมูลผ่านสถาปัตยกรรมไคลเอนต์-เซิร์ฟเวอร์
- โฮสต์: แอปพลิเคชันเช่น 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
ตัวอย่างการใช้งาน
ใช้พรอมต์ที่อธิบายผลลัพธ์ 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-flagset-feature-flag,delete-feature-flag(ผู้ดูแลระบบ; การลบแบบทำลายล้างถูกทำเครื่องหมายที่ระดับโปรโตคอล)
- การปรับใช้
redeployaccept-deploy: คอมมิตการเปลี่ยนแปลงที่จัดเตรียมไว้และปรับใช้ (ทำลายล้าง; ไคลเอนต์จะแจ้งให้ยืนยัน)
- เอเจนต์
railway-agent: ส่งคำขอภาษาธรรมชาติให้เอเจนต์ AI ของ Railway สำหรับการดำเนินการหลายขั้นตอน เช่น การวิเคราะห์ล็อก การดีบัก และการกำหนดค่าบริการ
รันเซิร์ฟเวอร์ในเครื่อง
CLI ยังมาพร้อม MCP เซิร์ฟเวอร์ในกระบวนการสำหรับเครื่องที่ไม่สามารถเข้าถึง mcp.railway.com เช่น บนเครือข่ายที่จำกัดการส่งออก เริ่มด้วย railway mcp local หรือเขียนการกำหนดค่าสำหรับโปรแกรมแก้ไขที่รองรับด้วย railway mcp install --local เซิร์ฟเวอร์พูดกับ Railway API โดยตรงโดยใช้ข้อมูลรับรอง CLI ของคุณ ทำเครื่องหมายเครื่องมือที่ทำลายล้างด้วยคำใบ้ระดับโปรโตคอล และส่งคืนตัวอย่างก่อนที่จะต้องใช้ 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 คุณเลือกได้ว่าวิร์กสเปซและโปรเจกต์ใดที่ไคลเอนต์เข้าถึงได้ โทเค็นมีอายุสั้นและสามารถเพิกถอนได้จากการตั้งค่าบัญชี Railway ของคุณ
- การดำเนินการที่ทำลายล้าง ถูกทำเครื่องหมายที่ระดับโปรโตคอล ไคลเอนต์ที่เคารพคำใบ้เหล่านี้จะแจ้งให้ยืนยัน
- ไม่ยอมรับโทเค็นโปรเจกต์ เซิร์ฟเวอร์ต้องมีข้อมูลประจำตัวผู้ใช้สำหรับการเรียกเก็บเงินและการตรวจสอบย้อนกลับ
คุณควร:
- ตรวจสอบการดำเนินการ ที่ LLM ขอก่อนอนุมัติ โดยเฉพาะการดำเนินการที่ทำลายล้าง (
redeploy,accept-deploy,railway-agent, และของเซิร์ฟเวอร์ในเครื่องremove_service,delete_domain,remove_tcp_proxy,remove_bucket, และremove_volume) - จำกัดการเข้าถึง เพื่อให้แน่ใจว่ามีเพียงผู้ใช้ที่เชื่อถือได้เท่านั้นที่สามารถเรียกใช้ MCP เซิร์ฟเวอร์ได้
- หลีกเลี่ยงความเสี่ยงในการผลิต โดยจำกัดการใช้งานเฉพาะสภาพแวดล้อมที่ไม่สำคัญเท่าที่เป็นไปได้
คำขอฟีเจอร์
แบ่งปันคำขอฟีเจอร์บน โพสต์ Railway MCP Server Central Station