Railway基础设施管理服务

铁路MCP服务器

Let Claude and other MCP clients manage your Railway.app infrastructure. Deploy services, manage variables, and monitor deployments - all through natural language.

A. 模型上下文协议（MCP） 用于与集成的服务器 Railway.app 平台。

目录

Features • Installation • Available Tools • Example Workflows • Security • Troubleshooting • Contributing

特性

• ✅ 使用铁路API令牌进行身份验证
• ✅ 项目管理（列表、信息、删除）
• ✅ 部署管理（列表、重启）
• ✅ 服务管理（从GitHub仓库或Docker镜像创建，列表）
• ✅ 变量管理（列表、创建/更新、删除）
• ✅ 服务网络管理
• ✅ 卷管理
• ❌ 完全支持所有模板
  • 🚧🔨⏳数据库模板支持
  • 自动数据库和网络工作流程
• 🚧🔨⏳最常用的工作流
• ❌ 服务的自动GitHub存储库链接

安装

先决条件

• Node.js 18+（用于内置fetch API支持）
• 活跃的铁路账户
• 铁路API令牌（在https://railway.app/account/tokens)

快速开始

此MCP服务器旨在与MCP客户端配合使用，例如：

• 克劳德桌面版|✅ 战斗测试
• 光标|✅ 需要测试
• 克莱恩|🚧🔨⏳ 需要测试
• 风浪|🚧🔨⏳ 需要测试
• 其他MCP客户端|🚧🔨⏳ 需要测试

通过Smithery安装

要自动安装铁路mcp，我们建议使用 铁匠铺

克劳德桌面版

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

光标

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

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

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

{
  "mcpServers": {
    // ... All of your existing MCP servers ...

    // Add the railway-mcp server to your configuration with your API token
    "railway": {
      "command": "npx",
      "args": ["-y", "@jasontanswe/railway-mcp"],
      "env": {
        "RAILWAY_API_TOKEN": "your-railway-api-token-here"
      }
    }
  }
}

Please list all my Railway projects

Please configure the Railway API with my token: {YOUR_API_TOKEN_HERE}

建议和其他信息

此服务器最好与有权访问终端的MCP客户端或Git结合使用 **（光标，风帆）**建议将此MCP与其他MCP一起使用，因为铁路MCP可以协调容器并无缝简化部署过程。

建议与MCP服务器结合使用

• Git|| 官方链接
• GitHub|| 官方 || 铁匠铺

对于克劳德

• 开箱即用，Claude没有终端访问权限，因此它无法触发部署，因为它无法获得最新的提交。
• 启动不同的服务并对其进行监控是Claude的最佳用例。

对于光标

• 与GitHub MCP一起使用，或者在GitHub上设置存储库并在您的机器上本地克隆，以利用与railway MCP的完全集成。
• 当Cursor进行更改时，它可能会忘记将更改推送到GitHub，导致它尝试部署Railway无法拉取的提交。
  • 解决方案： 始终在提示中询问或包含以下内容： Have you pushed our changes to GitHub yet?

安全注意事项

• 铁路API令牌提供对您帐户的完全访问。确保它们的安全。
• 使用环境变量方法时，您的令牌存储在Claude Desktop配置文件中。
• 敏感变量值在显示时会自动屏蔽。
• 所有API调用都使用HTTPS进行安全通信。
• 服务器的内存专用令牌存储意味着您的令牌永远不会写入配置文件之外的磁盘。

故障排除

如果您遇到问题：

1. 令牌身份验证问题

   • 请确保您的API令牌有效并且具有必要的权限
   • 如果使用环境变量方法，请检查配置文件中的令牌格式是否正确
   • 尝试使用 configure 如果环境令牌不起作用，则直接在Claude中使用该工具

2. 服务器连接问题

   • 检查您是否安装了最新版本的服务器
   • 验证是否安装了Node.js版本18或更高版本
   • 更改配置后重新启动Claude for Desktop

3. API错误

   • 验证您是否使用了正确的项目、环境和服务ID
   • 检查铁路的状态页面是否有任何服务中断
   • 铁路API有费率限制-避免在短时间内提出过多请求

贡献

我们欢迎社区的贡献！请查看我们的 贡献指南 有关如何开始、开发指南和调试信息的详细信息。

可用工具