Railway MCP Server

Railway MCP Server là một máy chủ Model Context Protocol (MCP) cho phép tương tác bằng ngôn ngữ tự nhiên với các dự án và cơ sở hạ tầng Railway của bạn. Hãy yêu cầu IDE hoặc trợ lý AI của bạn tạo dự án, triển khai mẫu, quản lý môi trường, lấy biến, triển khai lại dịch vụ, v.v.

Railway cung cấp hai cách kết nối:

• MCP Cục bộ — chạy thông qua Railway CLI trên máy của bạn. Được khuyến nghị cho hầu hết các quy trình làm việc với tác nhân lập trình vì nó chia sẻ xác thực và ngữ cảnh dự án của CLI.
• MCP Từ xa — một điểm cuối được lưu trữ tại mcp.railway.com. Không cần cài đặt cục bộ hoặc CLI; máy khách xác thực qua OAuth trong trình duyệt.

Bắt đầu nhanh

Cài đặt Railway CLI và cấu hình hỗ trợ tác nhân — kỹ năng, MCP và xác thực — chỉ trong một lệnh. Chuyển đổi các tùy chọn để tùy chỉnh lệnh theo những gì bạn muốn thiết lập:

Nếu CLI đã được cài đặt, bỏ qua bước khởi tạo và chạy:

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

Đọc tiếp để biết cấu hình thủ công cho từng trình soạn thảo, danh sách công cụ có sẵn và các cân nhắc về bảo mật.

Cấu hình cho từng trình soạn thảo

Nếu bạn muốn tự kết nối trình soạn thảo — hoặc muốn xem chính xác những gì railway mcp install ghi — hãy sử dụng nút chuyển đổi để chuyển giữa cấu hình stdio cục bộ và cấu hình HTTP từ xa:

railway mcp install hợp nhất mục nhập máy chủ Railway vào các cấu hình hiện có mà không xóa các máy chủ MCP khác. Chạy lại bất cứ lúc nào để cập nhật.

Tìm hiểu về MCP

Model Context Protocol (MCP) định nghĩa một tiêu chuẩn về cách các ứng dụng AI (máy chủ) có thể tương tác với các công cụ và nguồn dữ liệu bên ngoài thông qua kiến trúc máy khách-máy chủ.

• Máy chủ: Các ứng dụng như Cursor, VS Code, Claude Code hoặc Windsurf kết nối với các máy chủ MCP.
• Máy khách: Lớp bên trong máy chủ duy trì kết nối một-một với các máy chủ MCP riêng lẻ.
• Máy chủ: Các chương trình độc lập (như Railway MCP Server) cung cấp các công cụ và quy trình làm việc để quản lý hệ thống bên ngoài.

Railway MCP Server cục bộ dịch các yêu cầu ngôn ngữ tự nhiên thành các quy trình CLI được hỗ trợ bởi Railway CLI. Máy chủ MCP từ xa chạy trên cơ sở hạ tầng của Railway và xác thực qua OAuth.

Điều kiện tiên quyết

• MCP Cục bộ — cài đặt và xác thực Railway CLI.
• MCP Từ xa — một tài khoản Railway. Không cần cài đặt cục bộ.

Ví dụ sử dụng

• Tạo và triển khai một ứng dụng mới

  Create a Next.js app in this directory and deploy it to Railway.
  Also assign it a domain.
  

• Triển khai từ một mẫu

  Deploy a Postgres database
  

• Lấy biến môi trường

  Pull environment variables for my project and save them to a .env file
  

• Gỡ lỗi triển khai thất bại (công cụ chỉ dành cho từ xa railway-agent)

  Use the railway agent to figure out why my backend service is
  crashing on deploy
  

• Triển khai lại một dịch vụ

  Redeploy my api service in the production environment
  

Các công cụ MCP có sẵn

Railway MCP Server cung cấp một bộ công cụ được tuyển chọn. Trợ lý AI của bạn sẽ tự động gọi chúng dựa trên ngữ cảnh yêu cầu của bạn.

MCP Cục bộ

Máy chủ cục bộ chạy qua Railway CLI và cung cấp một bộ công cụ CRUD rộng hơn:

• Trạng thái
  • check-railway-status — xác minh cài đặt và xác thực CLI
• Dự án & dịch vụ
  • list-projects, create-project-and-link
  • list-services, link-service
  • deploy — triển khai một dịch vụ
  • deploy-template — triển khai từ Thư viện Mẫu Railway
• Môi trường
  • create-environment, link-environment
• Cấu hình
  • list-variables, set-variables
  • generate-domain
• Khả năng quan sát
  • get-logs

MCP Từ xa

Máy chủ từ xa cung cấp một bộ công cụ tập trung cùng với một điểm vào tác nhân mạnh mẽ. Đối với bất kỳ điều gì phức tạp, hãy ủy quyền cho railway-agent.

• Tài khoản
  • whoami
• Dự án
  • list-projects, create-project, list-services
• Triển khai
  • redeploy
  • accept-deploy — cam kết các thay đổi đã staged và triển khai (có tính hủy hoại; máy khách nhắc xác nhận)
• Tác nhân
  • railway-agent — gửi yêu cầu ngôn ngữ tự nhiên cho tác nhân AI của Railway để thực hiện các thao tác nhiều bước như phân tích nhật ký, gỡ lỗi và cấu hình dịch vụ

Cân nhắc về bảo mật

Railway MCP Server chạy các lệnh CLI hoặc gọi API Railway thay mặt bạn. Các thao tác có tính hủy hoại được cố ý loại trừ khỏi danh sách công cụ của máy chủ cục bộ, nhưng bạn vẫn nên:

• Xem xét các hành động được LLM yêu cầu trước khi phê duyệt, đặc biệt là những hành động có tính hủy hoại (redeploy, accept-deploy, railway-agent).
• Hạn chế quyền truy cập để đảm bảo chỉ những người dùng đáng tin cậy mới có thể gọi máy chủ MCP.
• Tránh rủi ro sản xuất bằng cách giới hạn sử dụng trong các môi trường không quan trọng nếu có thể.

Riêng đối với máy chủ từ xa:

• Phạm vi OAuth. Khi bạn đồng ý, bạn chọn không gian làm việc và dự án nào mà máy khách có thể truy cập. Token có thời hạn ngắn và có thể bị thu hồi từ cài đặt tài khoản Railway của bạn.
• Các hành động hủy hoại được đánh dấu ở cấp độ giao thức. Các máy khách tôn trọng những gợi ý này sẽ nhắc xác nhận.
• Token dự án không được chấp nhận. Máy chủ MCP từ xa yêu cầu danh tính người dùng cho mục đích thanh toán và theo dõi kiểm toán.

Yêu cầu tính năng

Railway MCP Server đang trong quá trình phát triển. Chúng tôi đang tích cực bổ sung thêm nhiều công cụ và tính năng. Nếu bạn có yêu cầu tính năng, hãy để lại phản hồi trên bài đăng Central Station này.