allkindsxyz/railway-mcp-server

Railway MCP Server

Model Context Protocol (MCP) сервер для Railway API - позволяет AI системам (Claude, Cursor и другим) напрямую управлять Railway проектами, деплоями и сервисами.

🚀 Возможности

Управление проектами

• Просмотр всех проектов и их сервисов
• Получение детальной информации о проекте
• Мониторинг статуса сервисов

Управление деплоями

• Просмотр логов деплоев (build logs, deploy logs)
• Запуск нового деплоя (redeploy)
• Отмена текущего деплоя
• Перезапуск деплоя

Управление переменными окружения

• Просмотр переменных сервиса
• Создание/обновление переменных
• Удаление переменных

Мониторинг

• Статус деплоев в реальном времени
• URL адреса сервисов
• Метаданные проектов и сервисов

📦 Установка

Требования

• Node.js 18+
• Railway API токен

Быстрая установка

# Клонировать репозиторий
git clone <your-repo-url>
cd railway-mcp-server

# Установить зависимости
npm install

# Собрать проект
npm run build

Получение Railway API токена

1. Зайдите на Railway
2. Перейдите в Account Settings → Tokens
3. Создайте новый токен
4. Скопируйте токен

🔧 Настройка

Для Claude Desktop

Добавьте в конфигурацию Claude Desktop (claude_desktop_config.json):

На macOS:

~/Library/Application\ Support/Claude/claude_desktop_config.json

На Windows:

%APPDATA%/Claude/claude_desktop_config.json

Конфигурация:

{
  "mcpServers": {
    "railway": {
      "command": "node",
      "args": ["/absolute/path/to/railway-mcp-server/dist/index.js"],
      "env": {
        "RAILWAY_TOKEN": "your-railway-token-here"
      }
    }
  }
}

Для Cursor

Добавьте в настройки Cursor:

{
  "mcpServers": {
    "railway": {
      "command": "node",
      "args": ["/absolute/path/to/railway-mcp-server/dist/index.js"],
      "env": {
        "RAILWAY_TOKEN": "your-railway-token-here"
      }
    }
  }
}

🛠️ Использование

Основные команды

После настройки вы можете использовать следующие команды в Claude или Cursor:

Просмотр проектов

Покажи мне все мои Railway проекты

Просмотр конкретного проекта

Покажи детали проекта {project-id}

Просмотр логов деплоя

Покажи логи деплоя {deployment-id}

Перезапуск сервиса

Перезапусти сервис {service-id}

Управление переменными

Установи переменную NODE_ENV=production для сервиса {service-id}

Доступные инструменты

🧪 Тестирование

Использование MCP Inspector

# Запустить инспектор для отладки
npm run inspector

Откройте браузер по указанному URL для интерактивного тестирования.

Тестирование из командной строки

# Установить переменную окружения
export RAILWAY_TOKEN="your-token-here"

# Запустить сервер
npm start

📖 Примеры использования

Мониторинг деплоев

Claude: Покажи мне статус всех деплоев в проекте Marvin

Управление переменными

Claude: Установи переменную DATABASE_URL для backend сервиса

Анализ логов

Claude: Покажи логи последнего деплоя и найди ошибки

Автоматический редеплой

Claude: Если деплой frontend завершился с ошибкой, перезапусти его

🔒 Безопасность

• Токены: Railway токены хранятся только в переменных окружения
• Локальное выполнение: MCP сервер работает локально
• Подтверждение действий: Изменяющие операции требуют подтверждения
• Изоляция: Каждый сервис работает в изолированном контексте

🐛 Отладка

Проверка токена

# Проверить валидность токена
curl -H "Authorization: Bearer your-token" https://backboard.railway.app/graphql/v2

Логи сервера

# Просмотр логов
npm run dev

Общие проблемы

1. "RAILWAY_TOKEN is required" - Убедитесь, что токен установлен
2. "Unauthorized" - Проверьте корректность токена
3. "Tool not found" - Перезапустите Claude Desktop

📚 Дополнительные ресурсы

• Railway API Documentation
• Model Context Protocol
• Claude Desktop Documentation

🤝 Содействие

Чтобы внести свой вклад:

1. Форкните репозиторий
2. Создайте feature branch
3. Внесите изменения
4. Создайте pull request

📄 Лицензия

MIT License - смотрите файл для деталей.

🆘 Поддержка

• Создайте GitHub Issue для багов
• Обратитесь в Railway Discord для вопросов по API
• Документация MCP для общих вопросов

Создано командой Marvin Studio 🚀