Railway MCP

आधिकारिक

Railway MCP सर्वर आपके Railway प्रोजेक्ट्स और इंफ्रास्ट्रक्चर के साथ प्राकृतिक भाषा में इंटरैक्शन सक्षम बनाता है। अपने IDE या AI सहायक से प्रोजेक्ट बनाने, टेम्पलेट डिप्लॉय करने, एनवायरनमेंट प्रबंधित करने, वेरिएबल खींचने, सेवाओं को पुनः डिप्लॉय करने और अधिक के लिए कहें।

Railway MCP के साथ आप क्या कर सकते हैं?

  • ऐप बनाएं और डिप्लॉय करें — Next.js ऐप का स्कैफोल्ड बनाने, उसे डिप्लॉय करने और create_project तथा generate_domain के ज़रिए डोमेन असाइन करने के लिए कहें।
  • टेम्पलेट से डिप्लॉय करेंsearch_templates और deploy_template का उपयोग करके Postgres जैसे तैयार टेम्पलेट खोजें और डिप्लॉय करें।
  • एनवायरनमेंट वेरिएबल प्रबंधित करें.env फ़ाइल में वेरिएबल खींचें या list_variables और set_variables से उन्हें सेट करें।
  • सेवाओं को फिर से डिप्लॉय करेंredeploy टूल से किसी विशेष एनवायरनमेंट में सेवा का पुनः डिप्लॉयमेंट ट्रिगर करें।
  • असफल डिप्लॉयमेंट की डिबगिंग — क्रैश का निदान करने के लिए railway-agent को प्राकृतिक-भाषा डिबगिंग अनुरोध सौंपें।
  • फीचर फ्लैग प्रबंधित करेंlist-feature-flags और set-feature-flag के माध्यम से प्रोजेक्ट पर फीचर फ्लैग सूचीबद्ध करें, प्राप्त करें या सेट करें।

दस्तावेज़

The Railway MCP सर्वर Model Context Protocol (MCP) को लागू करता है। यह AI सहायकों को प्रोजेक्ट बनाने, टेम्पलेट्स तैनात करने, वातावरण प्रबंधित करने, वेरिएबल्स खींचने और सेवाओं को फिर से तैनात करने की अनुमति देता है।

Railway दो MCP सर्वर प्रदान करता है:

  • Local MCP आपकी मशीन पर Railway CLI के माध्यम से चलता है और स्थानीय CLI संदर्भ का उपयोग करता है।
  • Remote MCP mcp.railway.com पर चलता है। OAuth का उपयोग करके सीधे कनेक्ट करें, या अपने railway login सत्र से क्रेडेंशियल्स का पुन: उपयोग करने के लिए railway mcp proxy चलाएँ।

त्वरित आरंभ

Railway CLI स्थापित करें और एजेंट कौशल, 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 प्रॉक्सी के माध्यम से Remote MCP, और OAuth के साथ Remote MCP के बीच स्विच करने के लिए चयनकर्ता का उपयोग करें:

railway mcp install Railway सर्वर प्रविष्टि को मौजूदा कॉन्फ़िगरेशन में अन्य MCP सर्वरों को हटाए बिना मर्ज करता है। किसी भी समय अपडेट करने के लिए इसे फिर से चलाएँ।

MCP को समझना

Model Context Protocol (MCP) एक मानक को परिभाषित करता है कि AI अनुप्रयोग (होस्ट) क्लाइंट-सर्वर आर्किटेक्चर के माध्यम से बाहरी टूल और डेटा स्रोतों के साथ कैसे इंटरैक्ट कर सकते हैं।

  • होस्ट: Cursor, VS Code, Claude Code, या Windsurf जैसे अनुप्रयोग जो MCP सर्वरों से जुड़ते हैं।
  • क्लाइंट: होस्ट के भीतर की परत जो व्यक्तिगत MCP सर्वरों के साथ एक-से-एक कनेक्शन बनाए रखती है।
  • सर्वर: स्टैंडअलोन प्रोग्राम (जैसे Railway MCP सर्वर) जो बाहरी सिस्टम के प्रबंधन के लिए टूल और वर्कफ़्लो उजागर करते हैं।

लोकल MCP सर्वर प्राकृतिक भाषा के अनुरोधों को Railway CLI द्वारा संचालित CLI वर्कफ़्लो में अनुवादित करता है। Remote MCP Railway के इंफ्रास्ट्रक्चर पर चलता है और OAuth का समर्थन करता है। CLI प्रॉक्सी आपके railway login सत्र से Remote MCP को क्रेडेंशियल पास करके एक और कनेक्शन पथ प्रदान करता है।

पूर्वापेक्षाएँ

सर्वर और प्रमाणीकरण विधि यह निर्धारित करती है कि आपको किन स्थानीय टूल और क्रेडेंशियल की आवश्यकता है।

  • Local MCP के लिए एक स्थापित और प्रमाणित Railway CLI आवश्यक है।
  • Remote MCP के लिए Railway खाते की आवश्यकता है। प्रत्यक्ष OAuth को CLI की आवश्यकता नहीं होती। CLI प्रॉक्सी को एक स्थापित CLI और एक railway login सत्र की आवश्यकता होती है ताकि वह उन क्रेडेंशियल्स का पुन: उपयोग कर सके।

उदाहरण उपयोग

उन प्रॉम्प्ट का उपयोग करें जो 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 सर्वर निम्नलिखित टूल उजागर करता है। आपका 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: चरणबद्ध परिवर्तनों को कमिट करें और तैनात करें (विनाशकारी; क्लाइंट पुष्टिकरण के लिए संकेत देते हैं)
  • एजेंट
    • railway-agent: लॉग विश्लेषण, डिबगिंग, और सेवा कॉन्फ़िगरेशन जैसे बहु-चरणीय संचालन के लिए Railway के AI एजेंट को प्राकृतिक भाषा का अनुरोध सौंपें

सुरक्षा संबंधी विचार

Railway MCP सर्वर आपकी ओर से CLI कमांड चलाता है या Railway APIs को कॉल करता है। 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 प्रॉक्सी प्रमाणीकरण। प्रॉक्सी आपके railway login क्रेडेंशियल्स को पढ़ता और रीफ़्रेश करता है। एडिटर कॉन्फ़िगरेशन में दीर्घकालिक Railway क्रेडेंशियल नहीं होता।
  • OAuth स्कोपिंग। प्रत्यक्ष OAuth के साथ, आप चुनते हैं कि क्लाइंट किन वर्कस्पेस और प्रोजेक्ट तक पहुँच सकता है। टोकन अल्पकालिक होते हैं और आपके Railway खाता सेटिंग्स से रद्द किए जा सकते हैं।
  • विनाशकारी कार्रवाइयाँ प्रोटोकॉल स्तर पर चिह्नित होती हैं। इन संकेतों का सम्मान करने वाले क्लाइंट पुष्टिकरण के लिए संकेत देंगे।
  • प्रोजेक्ट टोकन स्वीकार नहीं किए जाते। Remote MCP को बिलिंग और ऑडिट ट्रेल के लिए उपयोगकर्ता पहचान की आवश्यकता होती है।

फीचर अनुरोध

Railway MCP सर्वर सेंट्रल स्टेशन पोस्ट पर फीचर अनुरोध साझा करें।