STARWARCLOUD STARWAR.AI
返回市场
铁路-MCP服务器

铁路-MCP服务器

作者：railwayapp86 星标更新：2025-09-27
安装使用来源：spider==github.com

项目介绍

Railway MCP Server

与您的Railway账户交互的模型上下文协议（MCP）服务器。这是一个本地MCP服务器，提供了一组用于管理Railway资源的工作流和工具。

[!重要] MCP服务器的设计中不包括破坏性操作，但您仍需注意执行的工具和命令。

预备条件

需要Railway CLI才能使此服务器正常运行。

安装

Cursor

您可以点击下方按钮将Railway MCP Server添加到Cursor中。

安装MCP服务器

或者，您可以在.cursor/mcp.json中添加以下配置：

{
  "mcpServers": {
    "railway-mcp-server": {
      "command": "npx",
      "args": ["-y", "@railway/mcp-server"]
    }
  }
}

VS Code:

在.vscode/mcp.json中添加以下配置：

{
  "servers": {
    "railway-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@railway/mcp-server"]
    }
  }
}

Claude Code:

claude mcp add railway-mcp-server -- npx -y @railway/mcp-server

示例用法

创建新项目，部署它，并生成一个域名

在此目录下创建一个Next.js应用程序并将其部署到Railway。确保为其分配一个域名。由于我们是从零开始，目前不需要拉取有关部署或构建的信息。

从模板部署（数据库、队列等）。根据您的提示，将选择并部署适当的模板。如果有多个模板，代理将选择最合适的模板。编写详细的提示将有助于更好的选择。查看所有可用模板。

部署Postgres数据库

部署单节点Clickhouse数据库

拉取环境变量

我希望拉取我的项目的环境变量并将它们保存到.env文件中

创建新的环境并设置为当前链接的环境

我希望创建一个新的名为`development`的开发环境，在那里我可以测试我的更改。这个环境应该复制生产环境。一旦环境创建完成，我希望将其设置为我当前链接的环境

CLI版本检测

MCP服务器会自动检测您的Railway CLI版本以使用适当的功能。

可用的MCP工具

Railway MCP Server提供了以下工具来管理您的Railway基础设施：

  • check-railway-status - 检查是否已安装Railway CLI且用户已登录
  • 项目管理
    • list-projects - 列出所有Railway项目
    • create-project-and-link - 创建新项目并将其链接到当前目录
  • 服务管理
    • list-services - 列出项目中的所有服务
    • link-service - 将服务链接到当前目录
    • deploy - 部署服务
    • deploy-template - 从Railway模板库部署模板
  • 环境管理
    • create-environment - 创建新的环境
    • link-environment - 将环境链接到当前目录
  • 配置及变量
    • list-variables - 列出环境变量
    • set-variables - 设置环境变量
    • generate-domain - 为项目生成一个railway.app域名
  • 监控及日志
    • get-logs - 获取服务的构建或部署日志
      • Railway CLI v4.9.0+: 支持lines参数限制输出和filter参数搜索日志
      • 旧版CLI: 将无过滤能力地流式传输日志

开发

预备条件

  • Node.js >= 20.0.0
  • pnpm >= 10.14.0

  1. 克隆仓库

    git clone https://github.com/railwayapp/railway-mcp-server.git
cd railway-mcp-server

  2. 安装依赖

    pnpm install

  3. 启动开发服务器

    pnpm dev

    此命令将在dist/下生成一个构建，并在进行更改后自动重新构建。

  4. 配置您的MCP客户端

    在您的MCP客户端（例如Cursor、VSCode）中添加以下配置，并将/path/to/railway-mcp-server/dist/index.js替换为您实际构建服务器的路径。

    Cursor: .cursor/mcp.json

    {
  "mcpServers": {
    "railway-mcp-server": {
      "command": "node",
      "args": ["/path/to/railway-mcp-server/dist/index.js"]
    }
  }
}

    VSCode: .vscode/mcp.json

    {
  "servers": {
    "railway-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/railway-mcp-server/dist/index.js"]
    }
  }
}

    对于Claude Code:

    claude mcp add railway-mcp-server node /path/to/railway-mcp-server/railway-mcp-server/dist/index.js