# Railway MCP Server

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

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

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

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

### Управление переменными окружения
- Просмотр переменных сервиса
- Создание/обновление переменных
- Удаление переменных

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

## 📦 Установка

### Требования
- Node.js 18+
- Railway API токен

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

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

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

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

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

1. Зайдите на [Railway](https://railway.app)
2. Перейдите в Account Settings → Tokens
3. Создайте новый токен
4. Скопируйте токен

## 🔧 Настройка

### Для Claude Desktop

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

#### На macOS:
```bash
~/Library/Application\ Support/Claude/claude_desktop_config.json
```

#### На Windows:
```bash
%APPDATA%/Claude/claude_desktop_config.json
```

#### Конфигурация:
```json
{
  "mcpServers": {
    "railway": {
      "command": "node",
      "args": ["/absolute/path/to/railway-mcp-server/dist/index.js"],
      "env": {
        "RAILWAY_TOKEN": "your-railway-token-here"
      }
    }
  }
}
```

### Для Cursor

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

```json
{
  "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}
```

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

| Инструмент | Описание |
|------------|----------|
| `get_projects` | Получить все проекты |
| `get_project` | Получить детали проекта |
| `get_service` | Получить детали сервиса |
| `get_deployment_logs` | Получить логи деплоя |
| `redeploy_service` | Перезапустить сервис |
| `cancel_deployment` | Отменить деплой |
| `restart_deployment` | Перезапустить деплой |
| `update_service_variable` | Обновить переменную |
| `delete_service_variable` | Удалить переменную |

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

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

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

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

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

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

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

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

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

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

### Анализ логов
```
Claude: Покажи логи последнего деплоя и найди ошибки
```

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

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

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

## 🐛 Отладка

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

### Логи сервера
```bash
# Просмотр логов
npm run dev
```

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

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

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

- [Railway API Documentation](https://docs.railway.app/reference/public-api)
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [Claude Desktop Documentation](https://docs.anthropic.com/claude/docs/desktop-app)

## 🤝 Содействие

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

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

## 📄 Лицензия

MIT License - смотрите файл [LICENSE](LICENSE) для деталей.

## 🆘 Поддержка

- Создайте [GitHub Issue](https://github.com/your-repo/issues) для багов
- Обратитесь в [Railway Discord](https://discord.gg/railway) для вопросов по API
- Документация [MCP](https://modelcontextprotocol.io/) для общих вопросов

---

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