鉄道MCPサーバー

Railway.appプラットフォームと統合するためのモデル コンテキスト プロトコル (MCP)サーバー。

目次

特徴

• ✅ 鉄道APIトークンによる認証

• ✅ プロジェクト管理（リスト、情報、削除）

• ✅ デプロイメント管理（リスト、再起動）

• ✅ サービス管理（GitHub リポジトリまたは Docker イメージから作成、リスト）

• ✅ 変数の管理（リスト、作成/更新、削除）

• ✅ サービスネットワーク管理

• ✅ ボリューム管理

• ❌ すべてのテンプレートを完全サポート

  • 🚧🔨⏳ データベーステンプレートのサポート

  • 自動データベースおよびネットワークワークフロー

• 🚧🔨⏳ 最もよく使用されるワークフロー

• ❌ サービスへのGitHubリポジトリの自動リンク

インストール

前提条件

• Node.js 18+ (組み込みのフェッチ API サポート用)

• 有効な鉄道アカウント

• Railway API トークン ( https://railway.app/account/tokensで作成)

クイックスタート

この MCP サーバーは、次のような MCP クライアントと連携するように設計されています。

• デスクトップ版Claude | ✅ 実戦テスト済み

• カーソル | ✅ テストが必要です

• クライン | 🚧🔨⏳ テストが必要です

• ウィンドサーフィン | 🚧🔨⏳ テストが必要です

• その他の MCP クライアント | 🚧🔨⏳ テストが必要です

Smithery経由でインストール

railway-mcpを自動的にインストールするには、 Smitheryを使用することをお勧めします。

クロードデスクトップ

カーソル

1. カーソル設定に行き、MCPセクションを見つけます

2. 「新しいMCPサーバーを追加」をクリックします

3. 好きな名前を付けてください。わかりやすいようにrailway-mcpをお勧めします。

4. このコマンドを「コマンド」セクションに貼り付けます。<RAILWAY_API_TOKEN> はアカウントの Railway トークンです。

1. Claude for Desktop 構成ファイルを作成または編集します。

   • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. API トークンを使用して、railway-mcp サーバーを構成に追加します。

複数の MCP サーバーがある場合、構成ファイルは次のようになります。

3. デスクトップ版のClaudeを再起動

4. ClaudeでRailwayツールを直接使用できるようになりました。例えば：

5. あるいは、トークンを構成ファイルに追加したくない場合は、次のコマンドを使用して Claude 内で構成できます。

推奨事項とその他の情報

このサーバーは、ターミナルにアクセスできるMCPクライアント、またはGit **（Cursor、Windsurf）**との組み合わせに最適です。railway-mcpはコンテナをオーケストレーションし、デプロイメントプロセスをシームレスに効率化するため、このMCPを他のMCPと併用することをお勧めします。

組み合わせるMCPサーバーを推奨

• Git ||公式リンク

• GitHub ||公式|| Smithery

クロードのために

• そのままでは、Claude にはターミナル アクセス権がないため、最新のコミットを取得できず、デプロイメントをトリガーできません。

• さまざまなサービスを起動して監視することが、Claude の最適な使用例です。

カーソル用

• GitHub MCP と併用するか、リポジトリを GitHub 上にセットアップしておき、自分のマシンにローカルにクローンして、railway-mcp との完全な統合を活用します。

• Cursor が変更を行うと、その変更を GitHub にプッシュし忘れ、Railway がプルできないコミットをデプロイしようとする可能性があります。

  • **解決策:**常に質問するか、プロンプトのどこかに次の内容を含めます: Have you pushed our changes to GitHub yet?

セキュリティに関する考慮事項

• Railway APIトークンはアカウントへのフルアクセスを提供します。安全に保管してください。

• 環境変数方式を使用する場合、トークンは Claude Desktop 構成ファイルに保存されます。

• 機密変数値は表示時に自動的にマスクされます。

• すべての API 呼び出しは、安全な通信のために HTTPS を使用します。

• サーバーのメモリのみのトークン ストレージは、トークンが構成ファイル外のディスクに書き込まれることはないことを意味します。

トラブルシューティング

問題が発生した場合:

1. トークン認証の問題

   • APIトークンが有効であり、必要な権限があることを確認してください

   • 環境変数方式を使用する場合は、設定ファイルでトークンが正しくフォーマットされていることを確認してください。

   • 環境トークンが機能しない場合は、Claude で直接configureツールを使用してみてください。

2. サーバー接続の問題

   • サーバーの最新バージョンがインストールされていることを確認してください

   • Node.jsバージョン18以降がインストールされていることを確認します

   • 設定を変更した後、Claude for Desktopを再起動します。

3. APIエラー

   • 正しいプロジェクト、環境、サービス ID を使用していることを確認します

   • 鉄道のステータスページでサービス中断の有無を確認してください

   • 鉄道APIにはレート制限があります。短期間にリクエストを多く送信しないようにしてください。

貢献

コミュニティからの貢献を歓迎します！開始方法、開発ガイドライン、デバッグ情報の詳細については、貢献ガイドラインをご覧ください。

利用可能なツール

認証

• configure - Railway API トークンを設定します (環境変数で指定されていない場合にのみ必要)

プロジェクト

• project-list - アカウント内のすべてのプロジェクトを一覧表示します

• project-info - 特定のプロジェクトに関する詳細情報を取得する

• project-create - オプションのチームIDで新しいプロジェクトを作成する

• project-delete - プロジェクトを削除する

• project-environments - プロジェクト内のすべての環境を一覧表示する

サービス

• service-list - 特定のプロジェクト内のすべてのサービスを一覧表示する

• service-info - 特定のサービスに関する詳細情報を取得する

• service-create-from-repo - GitHub リポジトリから新しいサービスを作成する

• service-create-from-image - Docker イメージから新しいサービスを作成する

• service-delete - プロジェクトからサービスを削除する

• service-restart - 特定の環境でサービスを再起動する

• service-update - サービス設定の更新（ビルドコマンド、開始コマンドなど） | 🚧 テストが必要です

展開

• deployment-list - サービスの最近のデプロイメントを一覧表示する

• deployment-trigger - サービスの新しいデプロイメントをトリガーする

• deployment-logs - 特定のデプロイメントのログを取得する

• deployment-health-check - デプロイメントのヘルス/ステータスを確認する

変数

• variable-list - サービスまたは環境の変数を一覧表示する

• variable-set - 変数を作成または更新する

• variable-delete - 変数を削除する

• variable-bulk-set - サービスの変数を一括更新する | 🚧 テストが必要です

• variable-copy - 環境間で変数をコピーする | 🚧 テストが必要です

データベース

• database-list-types - デプロイ可能なすべてのデータベースタイプを一覧表示します

• database-deploy - 新しいデータベースサービスをデプロイする

新しいサービスの設定

1. プロジェクトIDを取得するためにプロジェクトを一覧表示する

2. テンプレートから新しいサービスを作成する

3. 環境変数を追加する

4. サービスの展開を表示する

環境変数の管理

1. プロジェクトを一覧表示してプロジェクトIDを見つけます

2. 変数を一覧表示して現在設定されているものを確認します

3. 必要に応じて変数を作成または更新する

4. 古くなった変数を削除する