ARMADA MCP工具部署
铁路部署
选项1:使用GitHub部署(推荐)
- 推送到GitHub```bash
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**```bash
npm i -g @railway/cli
- 登录```bash
railway login
1. **初始化项目**```bash
cd mcp-tool
railway init
- 部署```bash
railway up
1. **设置环境变量**```bash
railway vars set PORT=3001
railway vars set NODE_ENV=production
选项3:使用Docker进行部署
- 构建Docker镜像```bash
cd mcp-tool
docker build -t armada-mcp .
1. **运行容器**```bash
docker run -d -p 3001:3001 --name armada-mcp armada-mcp
测试部署
健康检查```bash
curl https://YOUR-RAILWAY-SUBDOMAIN.up.railway.app/health
预期响应:```json
{"status":"healthy","uptime":123.45}
WebSocket连接```javascript
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
- 更新API路线
修改/workspace/armada-premium/app/api/validate/route.ts使用WebSocket客户端而不是直接验证。
扩展
- 副本计数:增加
railway.json实现高可用性 - 记忆:如果需要,在铁路仪表板中进行调整
- 健康检查:配置于
/health端点
监控
- 在铁路仪表板中查看日志
- 检查健康端点的状态
- 监控WebSocket连接
故障排除
连接被拒绝
- 检查服务器是否正在运行
- 验证WebSocket URL是否正确
- 确保铁路已完成部署
高延迟
- 考虑添加更多副本
- 检查铁路资源使用情况指标
内存问题
- 在铁路设置中增加容器内存
- 如果需要,优化验证算法
