ARMADA MCP工具部署

ARMADA MCP工具部署

铁路部署

选项1：使用GitHub部署（推荐）

1. 推送到GitHub

   复制

   cd /workspace/armada-premium
   git init
   git add mcp-tool/
   git commit -m "Add ARMADA MCP Tool"
   git remote add origin https://github.com/YOUR_USERNAME/armada-mcp.git
   git push -u origin main
   

2. 连接到铁路

   • 首选https://railway.app
   • 使用GitHub登录
   • 点击“新建项目”
   • 选择“从GitHub仓库部署”
   • 选择你的 armada-mcp 仓库
   • 选择 mcp-tool 以root身份访问目录

3. 配置环境

   • 在铁路仪表板中，转到您的服务
   • 点击“变量”选项卡
   • 添加： PORT=3001 （可选，默认为3001）
   • 添加： NODE_ENV=production

4. 部署

   • 铁路将自动检测 railway.json 和 Dockerfile
   • 点击“部署”开始

选项2：使用Railway CLI进行部署

1. 安装铁路CLI

   复制

   npm i -g @railway/cli
   

2. 登录

   复制

   railway login
   

3. 初始化项目

   复制

   cd mcp-tool
   railway init
   

4. 部署

   复制

   railway up
   

5. 设置环境变量

   复制

   railway vars set PORT=3001
   railway vars set NODE_ENV=production
   

选项3：使用Docker进行部署

1. 构建Docker镜像

   复制

   cd mcp-tool
   docker build -t armada-mcp .
   

2. 运行容器

   复制

   docker run -d -p 3001:3001 --name armada-mcp armada-mcp
   

测试部署

健康检查

curl https://YOUR-RAILWAY-SUBDOMAIN.up.railway.app/health

预期响应：

{"status":"healthy","uptime":123.45}

WebSocket连接

const WebSocket = require('ws');
const ws = new WebSocket('wss://YOUR-RAILWAY-SUBDOMAIN.up.railway.app');

ws.on('open', () => {
  console.log('Connected to ARMADA MCP');
  
  ws.send(JSON.stringify({
    action: 'validate',
    params: {
      content: 'Test content',
      corridor: 'jamaica'
    }
  }));
});

ws.on('message', (data) => {
  console.log(JSON.parse(data.toString()));
});

Next.js集成

更新Next.js环境以连接到MCP服务器：

1. 设置环境变量

   复制

   MCP_WS_URL=wss://YOUR-RAILWAY-SUBDOMAIN.up.railway.app
   

2. 更新API路线 修改 /workspace/armada-premium/app/api/validate/route.ts 使用WebSocket客户端而不是直接验证。

扩展

• 副本计数：增加 railway.json 实现高可用性
• 记忆：如果需要，在铁路仪表板中进行调整
• 健康检查：配置于 /health 端点

监控

• 在铁路仪表板中查看日志
• 检查健康端点的状态
• 监控WebSocket连接

故障排除

连接被拒绝

• 检查服务器是否正在运行
• 验证WebSocket URL是否正确
• 确保铁路已完成部署

高延迟

• 考虑添加更多副本
• 检查铁路资源使用情况指标

内存问题

• 在铁路设置中增加容器内存
• 如果需要，优化验证算法