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-flag
    • set-feature-flag, delete-feature-flag (ผู้ดูแลระบบ; การลบแบบทำลายล้างถูกทำเครื่องหมายที่ระดับโปรโตคอล)
  • การปรับใช้
    • redeploy
    • accept-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