AI导哈

Railway项目管理协议服务器

Railway MCP Server是一个基于模型上下文协议（MCP）的服务器，用于通过MCP兼容的AI助手部署和管理Railway平台的项目、服务、环境和部署。

  • by MehdiZare
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 MehdiZare/railway-docker-mcp

使用说明

铁路MCP服务器

模型上下文协议（MCP）服务器 铁路 平台。通过MCP兼容的AI助手部署和管理铁路项目、服务、环境和部署。

特性

  • 项目管理：列出、创建和管理铁路项目
  • 服务操作：列出服务、触发部署、管理配置
  • 环境管理：创建环境，管理环境变量
  • 部署控制：列出部署，检索构建/部署日志
  • 域名生成：为服务生成railway.app域
  • 模板部署：从Railway的模板库部署

工具

工具 说明
check_railway_status 验证API访问和身份验证
list_projects 列出所有无障碍铁路项目
create_project_and_link 创建新项目
list_services 列出项目中的服务
link_service 获取服务详细信息以了解上下文
deploy 触发服务的部署
list_deployments 列出服务的部署
get_logs 检索构建/部署日志
create_environment 创建新环境
link_environment 获取环境详细信息以了解上下文
list_variables 列出环境变量
set_variables 设置环境变量
generate_domain 生成railway.app域
deploy_template 从铁路模板库部署

安装

使用紫外线（推荐）

# Clone the repository
git clone https://github.com/MehdiZare/railway-docker-mcp.git
cd railway-docker-mcp

# Install dependencies
uv sync

# Run the server
RAILWAY_TOKEN=your_token uv run python -m railway_mcp

使用pip

pip install railway-mcp

使用Docker

docker build -t railway-mcp .
docker run -e RAILWAY_TOKEN=your_token railway-mcp

配置

服务器需要铁路API令牌进行身份验证：

环境变量 必填 说明
RAILWAY_TOKEN 是 铁路API代币
RAILWAY_API_URL 否 自定义API URL（默认值： https://backboard.railway.com/graphql/v2)

获取铁路代币

  1. 首选 铁路仪表板
  2. 创建新的API令牌
  3. 设置 RAILWAY_TOKEN 环境变量

与MCP客户端一起使用

克劳德桌面版

添加到您的Claude Desktop配置(~/.config/claude/claude_desktop_config.json 在Linux/macOS或 %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "railway": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/railway-docker-mcp", "python", "-m", "railway_mcp"],
      "env": {
        "RAILWAY_TOKEN": "your_token"
      }
    }
  }
}

Docker MCP

{
  "mcpServers": {
    "railway": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RAILWAY_TOKEN", "railway-mcp"],
      "env": {
        "RAILWAY_TOKEN": "your_token"
      }
    }
  }
}

发展

# Install development dependencies
uv sync --dev

# Run tests
uv run pytest

# Run linting
uv run ruff check .

# Format code
uv run ruff format .

MCP检验员测试

RAILWAY_TOKEN=your_token npx @modelcontextprotocol/inspector uv run python -m railway_mcp

许可证

MIT许可证-请参阅 许可证 了解详情。

相关 MCP