Enables management of Railway projects, services, and deployments, including viewing project details, monitoring deployment status and logs, redeploying and restarting services, and managing environment variables.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Railway MCP Server show me the deployment logs for my backend service"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Model Context Protocol (MCP) сервер для Railway API - позволяет AI системам (Claude, Cursor и другим) напрямую управлять Railway проектами, деплоями и сервисами.
Просмотр всех проектов и их сервисов
Получение детальной информации о проекте
Мониторинг статуса сервисов
Просмотр логов деплоев (build logs, deploy logs)
Запуск нового деплоя (redeploy)
Отмена текущего деплоя
Перезапуск деплоя
Просмотр переменных сервиса
Создание/обновление переменных
Удаление переменных
Статус деплоев в реальном времени
URL адреса сервисов
Метаданные проектов и сервисов
Related MCP server: Railway MCP Server
Node.js 18+
Railway API токен
# Клонировать репозиторий
git clone <your-repo-url>
cd railway-mcp-server
# Установить зависимости
npm install
# Собрать проект
npm run buildЗайдите на Railway
Перейдите в Account Settings → Tokens
Создайте новый токен
Скопируйте токен
Добавьте в конфигурацию Claude Desktop (claude_desktop_config.json):
~/Library/Application\ Support/Claude/claude_desktop_config.json%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:
{
"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}Инструмент | Описание |
| Получить все проекты |
| Получить детали проекта |
| Получить детали сервиса |
| Получить логи деплоя |
| Перезапустить сервис |
| Отменить деплой |
| Перезапустить деплой |
| Обновить переменную |
| Удалить переменную |
# Запустить инспектор для отладки
npm run inspectorОткройте браузер по указанному URL для интерактивного тестирования.
# Установить переменную окружения
export RAILWAY_TOKEN="your-token-here"
# Запустить сервер
npm startClaude: Покажи мне статус всех деплоев в проекте MarvinClaude: Установи переменную DATABASE_URL для backend сервисаClaude: Покажи логи последнего деплоя и найди ошибкиClaude: Если деплой frontend завершился с ошибкой, перезапусти егоТокены: Railway токены хранятся только в переменных окружения
Локальное выполнение: MCP сервер работает локально
Подтверждение действий: Изменяющие операции требуют подтверждения
Изоляция: Каждый сервис работает в изолированном контексте
# Проверить валидность токена
curl -H "Authorization: Bearer your-token" https://backboard.railway.app/graphql/v2# Просмотр логов
npm run dev"RAILWAY_TOKEN is required" - Убедитесь, что токен установлен
"Unauthorized" - Проверьте корректность токена
"Tool not found" - Перезапустите Claude Desktop
Чтобы внести свой вклад:
Форкните репозиторий
Создайте feature branch
Внесите изменения
Создайте pull request
MIT License - смотрите файл LICENSE для деталей.
Создайте GitHub Issue для багов
Обратитесь в Railway Discord для вопросов по API
Документация MCP для общих вопросов
Создано командой Marvin Studio 🚀
Cancel a running deployment
Inputs: deploymentId (required).
Delete an environment variable from a service
Inputs: serviceId (required), name (required).
Get logs for a specific deployment
Inputs: deploymentId (required).
Get details of a specific Railway project
Inputs: projectId (required).
Get all Railway projects and their services
Inputs: no named parameters.
Get details of a specific Railway service including deployments and variables
Inputs: serviceId (required).
Trigger a new deployment for a service
Inputs: serviceId (required).
Restart a deployment
Inputs: deploymentId (required).
Update or create an environment variable for a service
Inputs: serviceId (required), name (required), value (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 9 tools
Each tool has a clearly distinct purpose targeting specific resources and actions, such as cancel_deployment vs. restart_deployment, and get_project vs. get_service, with no overlapping functionality that would cause confusion.
All tool names follow a consistent verb_noun pattern using snake_case, such as get_deployment_logs and update_service_variable, with no deviations in style or convention throughout the set.
With 9 tools, the server is well-scoped for managing Railway projects, services, deployments, and environment variables, providing a focused set that covers essential operations without being overwhelming or insufficient.
The tool set offers strong coverage for deployment management, environment variables, and project/service queries, but minor gaps exist, such as the inability to create or delete projects or services, which agents might need to work around.
Develop, manage, and debug Railway projects, services, and deployments from within agents.
Deploy and run your apps by asking your AI: services, Postgres, logs, traces, rollbacks, costs.
Deploy apps from GitHub, read build/runtime logs, and manage your app's users from your AI agent.
Deploy local apps, add managed Postgres, and inspect logs from your AI coding agent.
