Railway MCP Server

🚀 Railway MCP Server (Experimental)

このサーバーは、Railwayアカウントとやり取りするためのModel Context Protocol (MCP)サーバーです。このローカルのMCPサーバーは、Railwayリソースを管理するための一連の独自のワークフローとツールを提供します。

⚠️ 重要提示

これは実験的なプロジェクトです（本当に実験的です）。バグや機能不足があることを想定してください。MCPサーバーは設計上、破壊的なアクションを含んでいませんが、実行されるツールやコマンドには依然として注意を払う必要があります。

🚀 クイックスタート

前提条件

このサーバーを機能させるには、Railway CLIが必要です。

📦 インストール

Cursor

以下の設定を .cursor/mcp.json に追加してください。

{
  "mcpServers": {
    "railway-mcp-server": {
      "command": "npx",
      "args": ["-y", "@railway/mcp-server"]
    }
  }
}

VS Code

以下の設定を .vscode/mcp.json に追加してください。

{
  "servers": {
    "railway-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@railway/mcp-server"]
    }
  }
}

💻 使用例

基本的な使用法

新しいプロジェクトを作成し、デプロイし、ドメインを生成する例です。

このディレクトリにNext.jsアプリを作成し、Railwayにデプロイします。また、ドメインを割り当てるようにしてください。最初から始めるので、現時点ではデプロイやビルドに関する情報を取得する必要はありません。

テンプレートからのデプロイ（データベース、キューなど）。あなたのプロンプトに基づいて、適切なテンプレートが選択され、デプロイされます。複数のテンプレートがある場合、エージェントは最も適切なものを選択します。詳細なプロンプトを書くと、より良い選択が可能になります。利用可能なすべてのテンプレートを確認する

Postgresデータベースをデプロイする

シングルノードのClickhouseデータベースをデプロイする

環境変数の取得

私のプロジェクトの環境変数を取得し、.envファイルに保存したいです。

新しい環境を作成し、現在のリンク環境として設定する

私は変更をテストできる `development` という名前の新しい開発環境を作成したいです。この環境は本番環境を複製する必要があります。環境が作成されたら、それを現在のリンク環境として設定したいです。

✨ 主な機能

Railway MCP Serverは、以下のツールを提供して、あなたのRailwayインフラストラクチャを管理します。

• check-railway-status - Railway CLIがインストールされていることと、ユーザーがログインしていることを確認します。
• プロジェクト管理
  • list-projects - すべてのRailwayプロジェクトをリストします。
  • create-project-and-link - 新しいプロジェクトを作成し、現在のディレクトリにリンクします。
• サービス管理
  • list-services - プロジェクト内のすべてのサービスをリストします。
  • link-service - サービスを現在のディレクトリにリンクします。
  • deploy - サービスをデプロイします。
  • deploy-template - Railway Template Library からテンプレートをデプロイします。
• 環境管理
  • create-environment - 新しい環境を作成します。
  • link-environment - 環境を現在のディレクトリにリンクします。
• 設定と変数
  • list-variables - 環境変数をリストします。
  • set-variables - 環境変数を設定します。
  • generate-domain - プロジェクトにrailway.appドメインを生成します。
• 監視とログ
  • get-logs - サービスのビルドまたはデプロイログを取得します。

🔧 技術詳細

前提条件

• Node.js >= 20.0.0
• pnpm >= 10.14.0

1. リポジトリをクローンする

git clone https://github.com/railwayapp/railway-mcp-server.git
cd railway-mcp-server

2. 依存関係をインストールする

pnpm install

3. 開発サーバーを起動する

pnpm dev

このコマンドは dist/ の下にビルドを生成し、変更を加えた後は自動的に再ビルドします。

4. MCPクライアントを設定する MCPクライアント（Cursor、VSCodeなど）に以下の設定を追加し、/path/to/railway-mcp-server/dist/index.js を実際のビルド済みサーバーのパスに置き換えてください。

Cursor: .cursor/mcp.json

{
  "mcpServers": {
    "railway-mcp-server": {
      "command": "node",
      "args": ["/path/to/railway-mcp-server/dist/index.js"]
    }
  }
}

VSCode: .vscode/mcp.json

{
  "servers": {
    "railway-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/railway-mcp-server/dist/index.js"]
    }
  }
}