AntBot MCP Server

AntBot MCP服务器

AntBot MCP服务器表示 模型上下文协议（MCP） 基于TypeScript的服务器，旨在与基于AI的RPA平台AntBot集成。\ 该服务器与MCP客户端交互，并提供用于管理和执行AntBot项目的工具。

主要功能

• MCP Tool服务器界面 实施
• 查看AntBot项目列表 (Get_AntBot_Project_List)
• 查看项目详细信息 (Get_AntBot_Project_Info）-包含参数信息
• 运行项目 (Run_AntBot_Project）-支持参数传递
• 检测正在运行的进程 -避免重复运行（Windows环境）
• 查看运行日志 (Get_Last_Mcprun_Log）-检查最新的mcprun日志
• 管理自动设置 -从AntBot Robot设置文件自动加载设置
• 项目缓存 -缓存项目信息以优化性能
• 记录系统 -详细的日志记录和调试支持
• 基于TypeScript 模块化结构

🏗️ 体系结构

项目结构

src/
├── index.ts              # MCP 서버 진입점 및 메인 클래스
├── projectService.ts     # 프로젝트 관리 비즈니스 로직
├── logService.ts         # 로그 조회 서비스
├── api.ts                # 외부 API 호출 유틸리티
├── config.ts             # 설정 관리 및 검증
├── fileUtils.ts          # 파일 처리 유틸리티 (ZIP, XML 파싱)
├── logger.ts             # 로깅 시스템
├── schema.ts             # Zod 기반 입력 검증 스키마
├── types.ts              # TypeScript 타입 정의
└── constants.ts          # 상수 정의

核心组件

1. McpServer类 (index.ts)

- 管理MCP服务器实例 - 设置请求处理程序 - 错误处理和记录

1. ProjectService类 (projectService.ts)

- 查看项目列表 - 解析项目信息（antConf.xml） - 下载并运行项目 - 检测正在运行的进程（Windows tasklist） - 缓存系统

1. LogService类 (logService.ts)

- 查看mcprun日志文件 - 最新日志tail功能

1. 管理设置 (config.ts)

- 自动加载AntBot Robot配置文件 - 验证必需的设置 - 管理动态设置

🛠️ 安装和构建

前提条件

• Node.js v16或更高版本（建议使用LTS版本）
• Windows环境 （AntBot Runner进程检测功能）
• AntBot机器人 完成安装和管理器集成
• AntBot Robot配置文件 存在： %APPDATA%\Roaming\AntBotRobot\AntBot_Robot.exe.config

设置

# 프로젝트 클론
git clone 
cd antbot-mcp-server

# 의존성 설치
npm install

# 빌드
npm run build

# 또는 클린 빌드 (기존 빌드 파일 삭제 후 재빌드)
npm run cleanbuild

🧩 配置MCP工具

1.Get_AntBot_项目列表

在AntBot管理器中查看可用项目的列表。

{
  "name": "Get_AntBot_Project_List",
  "description": "Returns a list of antbot projects.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}

示例响应：

{
  "projects": [
    {
      "projectId": "PR000000298",
      "projectName": "웹 스크래핑 프로젝트",
      "description": "웹사이트에서 데이터를 수집하는 프로젝트"
    }
  ]
}

2.Get_AntBot_项目_信息

查询特定项目的详细信息和运行所需的参数。

{
  "name": "Get_AntBot_Project_Info",
  "description": "Get project information including required parameters",
  "inputSchema": {
    "type": "object",
    "properties": {
      "projectId": { "type": "string" }
    },
    "required": ["projectId"]
  }
}

示例响应：

{
  "projectId": "PR000000298",
  "projectPath": "C:\\temp\\project_298\\antConf.xml",
  "name": "웹 스크래핑 프로젝트",
  "description": "웹사이트에서 데이터를 수집하는 프로젝트",
  "requiredParameters": [
    {
      "name": "url",
      "type": "string",
      "description": "스크래핑할 웹사이트 URL"
    }
  ],
  "optionalParameters": [
    {
      "name": "timeout",
      "type": "number",
      "description": "타임아웃 시간 (초)",
      "defaultValue": 30
    }
  ],
  "parameterSummary": "필수: url (string) | 선택: timeout (number, 기본값: 30)"
}

3.Run_AntBot_项目

运行项目。首先 Get_AntBot_Project_Info必须调用以查看项目信息。

{
  "name": "Run_AntBot_Project",
  "description": "Run the project with required parameters",
  "inputSchema": {
    "type": "object",
    "properties": {
      "projectId": { "type": "string" },
      "projectPath": { "type": "string" },
      "parameters": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "required": ["projectId", "projectPath"]
  }
}

使用示例：

{
  "projectId": "PR000000298",
  "projectPath": "C:\\temp\\project_298\\antConf.xml",
  "parameters": {
    "url": "https://example.com",
    "timeout": 60
  }
}

避免重复运行：

• 运行前检查AntBot Runner进程状态
• 如果已经在运行 "현재 AntBot이 다른 작업을 수행 중입니다." 出现错误消息

4.获取Last_Mcprun_Log

查看最新mcprun日志的最后100行。

{
  "name": "Get_Last_Mcprun_Log",
  "description": "Returns the last 100 lines of the latest mcprun log.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}

示例响应：

{
  "fileName": "mcprun_20241201143022.log",
  "content": "2024-12-01 14:30:22 [INFO] 프로젝트 실행 시작\n2024-12-01 14:30:23 [INFO] 매개변수 로드 완료\n..."
}

🔧 主要脚本

🧪 测试方法

1.使用MCP Inspector

# MCP Inspector 설치
npm install -g @modelcontextprotocol/inspector

# 서버 테스트
npm run inspector

2.测试方案

1. 查看项目列表: Get_AntBot_Project_List 呼叫
2. 查看项目信息: Get_AntBot_Project_Info 呼叫（需要projectId）
3. 运行项目: Run_AntBot_Project 调用（需要projectId、projectPath、parameters）
4. 查看日志: Get_Last_Mcprun_Log 呼叫

🧠 Claude Desktop集成

前提条件

• Claude Desktop安装完成
• AntBot Robot经理已启动
• 使用MCP Inspector验证服务器正常运行

注册方法

方法1:Claude桌面GUI

1. 运行Claude Desktop
2. 设置→开发者→编辑设置
3. %APPDATA%\Roaming\Claude\claude_desktop_config.json 编辑文件

方法2：直接设置

{
  "mcpServers": {
    "antbot-mcp-server": {
      "command": "node",
      "args": ["C:\\path\\to\\antbot-mcp-server\\build\\index.js"]
    }
  }
}

重要信息：重新启动Claude Desktop

更改设置后 必须完全退出Claude Desktop并重新启动必须：

1. 右键单击系统托盘上的Claude图标
2. 结束 选择（完全退出）
3. 重新运行Claude Desktop

💡 请参见：设置必须通过托盘图标完全关闭，而不是简单地关闭窗口。

使用示例

您可以要求Claude：

• “让我看看AntBot项目列表”
• “告诉我PR000000298项目的信息”
• “请运行PR000000298项目”
• “让我看看最新的运行日志”

管理配置

加载自动设置

服务器将自动从以下路径读取AntBot Robot设置文件：

%APPDATA%\Roaming\AntBotRobot\AntBot_Robot.exe.config

必需的设置项目

• MANAGER_USER：管理器用户ID
• MANAGER_IP：管理服务器IP
• MANAGER_PORT：管理器服务器端口
• AntBot Runner：AntBot Runner可执行文件路径

验证设置

如果服务器启动时缺少必需的设置，则会引发错误：

AntBot Robot에서 매니저 연동을 먼저 진행해주세요.

🔍 记录和调试

日志位置

%USERPROFILE%\.AntBot\Log\Develop\

日志级别

• 信息：一般任务信息
• 调试：详细调试信息
• 警告：警告信息（流程检测失败等）
• 错误：错误信息

主要日志消息

• 初始化和启动服务器
• API调用结果
• 项目下载和运行状态
• 设置验证结果
• 查看AntBot Runner进程状态

mcprun日志

• 文件名格式： mcprun_YYYYMMDDHHMMSS.log
• 位置： %USERPROFILE%\.AntBot\Log\Develop\
• 通过MCP工具查看最新日志

📦 依赖性

核心依赖性

• @modelcontextprotocol/sdk：实施MCP服务器
• jsdom：解析XML配置文件
• adm-zip：处理项目ZIP文件
• sudo-prompt：运行管理员权限（必要时）
• xml2js：XML解析

开发依赖性

• typescript：TypeScript编译器
• rimraf：删除跨平台目录
• @types/*：类型定义

🚀 性能优化

缓存系统

• 缓存项目信息（5分钟）
• 避免重复下载
• 优化API调用

错误处理

• 详细错误消息
• 重试逻辑
• 优雅降级

流程管理

• 通过Windows tasklist检测进程
• 通过避免重复运行保护资源
• 保守处理（检测失败时允许运行）

🔒 安全性和可靠性

进程检测

• 仅在Windows环境中支持
• tasklist 通过命令验证安全流程
• 即使检测失败，也能保证可靠性

权限管理

• 通过sudo-propt运行管理员权限
• 仅在必要时才升级权限

📞 支持和联系

• AntBot相关：ICT AX解决方案团队
• MCP相关: MCP官方文档
• 问题报告：GitHub问题

📄 许可证

该项目在MIT许可下分发。