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

1. 连接到铁路

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

1. 配置环境

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

1. 部署

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

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

1. 安装铁路CLI

   npm i -g @railway/cli

1. 登录

   railway login

1. 初始化项目

   cd mcp-tool
   railway init

1. 部署

   railway up

1. 设置环境变量

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

选项3：使用Docker进行部署

1. 构建Docker镜像

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

1. 运行容器

   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

1. 更新API路线

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

扩展

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

监控

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

故障排除

连接被拒绝

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

高延迟

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

内存问题

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