Railway MCP Server

基本能力

产品定位

Railway MCP Server 是一个用于管理 Railway.app 基础设施的工具，通过自然语言与 MCP 客户端（如 Claude、Cursor 等）交互，实现项目、服务、部署和变量的管理。

核心功能

• ✅ 与 Railway API 令牌的认证
• ✅ 项目管理（列表、信息、删除）
• ✅ 部署管理（列表、重启）
• ✅ 服务管理（从 GitHub 仓库或 Docker 镜像创建、列表）
• ✅ 变量管理（列表、创建/更新、删除）
• ✅ 服务网络管理
• ✅ 卷管理
• 🚧 数据库模板支持（开发中）
• 🚧 常用工作流支持（开发中）

适用场景

• 通过自然语言管理 Railway.app 上的基础设施
• 快速部署服务并监控其状态
• 管理环境变量和服务配置
• 与 MCP 客户端（如 Claude、Cursor）集成，提升开发效率

工具列表

• 认证工具: configure - 设置 Railway API 令牌
• 项目管理工具: project-list, project-info, project-create, project-delete, project-environments
• 服务管理工具: service-list, service-info, service-create-from-repo, service-create-from-image, service-delete, service-restart, service-update
• 部署管理工具: deployment-list, deployment-trigger, deployment-logs, deployment-health-check
• 变量管理工具: variable-list, variable-set, variable-delete, variable-bulk-set, variable-copy
• 数据库管理工具: database-list-types, database-deploy

常见问题解答

1. 令牌认证问题: 确保 API 令牌有效且具有必要权限。
2. 服务器连接问题: 检查服务器版本和 Node.js 版本（需 18+）。
3. API 错误: 检查项目、环境和服务 ID 是否正确，避免频繁请求触发速率限制。

使用教程

使用依赖

• Node.js 18+（支持内置 fetch API）
• 有效的 Railway 账户
• Railway API 令牌（从 https://railway.app/account/tokens 创建）

安装教程

通过 Smithery 安装

Claude Desktop

npx -y @smithery/cli install @jason-tan-swe/railway-mcp --client claude

Cursor

npx -y @smithery/cli@latest run @jason-tan-swe/railway-mcp --config "{\"railwayApiToken\":\"token\"}"

手动安装（Cursor）

1. 在 Cursor 设置中找到 MCP 部分，添加新服务器。
2. 输入名称（如 railway-mcp）和命令：

npx -y @jasontanswe/railway-mcp <RAILWAY_API_TOKEN>

手动安装（Claude）

1. 编辑 Claude 配置文件（路径因操作系统而异）。
2. 添加以下配置：

"railway": {
  "command": "npx",
  "args": ["-y", "@jasontanswe/railway-mcp"],
  "env": {
    "RAILWAY_API_TOKEN": "your-railway-api-token-here"
  }
}

1. 重启 Claude。

调试方式

1. 确保 API 令牌正确配置。
2. 检查 Node.js 版本是否为 18+。
3. 使用 project-list 或 service-list 测试基本功能。
4. 查看部署日志（deployment-logs）以排查问题。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。