AntBot MCP Server

A TypeScript MCP server for integrating with the AntBot AI-based RPA platform, handling tool listing and execution.

AntBot MCP Server는Model Context Protocol (MCP)기반의 TypeScript 서버로, AI 기반 RPA 플랫폼인 AntBot과의 연동을 위해 설계되었습니다.
이 서버는 MCP 클라이언트와 상호작용하며, AntBot 프로젝트 관리 및 실행을 위한 도구들을 제공합니다.

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 # 상수 정의

# 프로젝트 클론 git clone <repository-url> cd antbot-mcp-server # 의존성 설치 npm install # 빌드 npm run build # 또는 클린 빌드 (기존 빌드 파일 삭제 후 재빌드) npm run cleanbuild

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

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

{ "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)" }

프로젝트를 실행합니다. 먼저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이 다른 작업을 수행 중입니다."메시지와 함께 오류 발생

{ "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..." }

# MCP Inspector 설치 npm install -g @modelcontextprotocol/inspector # 서버 테스트 npm run inspector

- 프로젝트 목록 조회:Get_AntBot_Project_List호출
- 프로젝트 정보 조회:Get_AntBot_Project_Info호출 (projectId 필요)
- 프로젝트 실행:Run_AntBot_Project호출 (projectId, projectPath, parameters 필요)
- 로그 조회:Get_Last_Mcprun_Log호출

- Claude Desktop 설치 완료
- AntBot Robot 매니저 연동 완료
- MCP Inspector로 서버 정상 동작 확인
- Claude Desktop 실행
- 설정 → 개발자 → 설정편집
- %APPDATA%\Roaming\Claude\claude_desktop_config.json파일 편집

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

설정 변경 후반드시 Claude Desktop을 완전히 종료하고 재시작해야 합니다:
- 시스템 트레이에서 Claude 아이콘 우클릭
- 종료선택 (완전히 종료)
- Claude Desktop 다시 실행

💡참고: 단순히 창을 닫는 것이 아니라 트레이 아이콘을 통해 완전히 종료해야 설정이 적용됩니다.

- "AntBot 프로젝트 목록을 보여줘"
- "PR000000298 프로젝트의 정보를 알려줘"
- "PR000000298 프로젝트를 실행해줘"
- "최신 실행 로그를 보여줘"

서버는 다음 경로의 AntBot Robot 설정 파일을 자동으로 읽어옵니다:

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

- MANAGER_USER: 매니저 사용자 ID
- MANAGER_IP: 매니저 서버 IP
- MANAGER_PORT: 매니저 서버 포트
- AntBot Runner: AntBot Runner 실행 파일 경로

- INFO: 일반적인 작업 정보
- DEBUG: 상세한 디버깅 정보
- WARN: 경고 정보 (프로세스 감지 실패 등)
- ERROR: 오류 정보

- 서버 초기화 및 시작
- API 호출 결과
- 프로젝트 다운로드 및 실행 상태
- 설정 검증 결과
- AntBot Runner 프로세스 상태 확인

- 파일명 형식:mcprun_YYYYMMDDHHMMSS.log
- 위치:%USERPROFILE%\.AntBot\Log\Develop\
- MCP 도구를 통해 최신 로그 조회 가능

- @modelcontextprotocol/sdk: MCP 서버 구현
- jsdom: XML 설정 파일 파싱
- adm-zip: 프로젝트 ZIP 파일 처리
- sudo-prompt: 관리자 권한 실행 (필요시)
- xml2js: XML 파싱

- typescript: TypeScript 컴파일러
- rimraf: 크로스 플랫폼 디렉토리 삭제
- @types/*: 타입 정의

- Windows tasklist를 통한 프로세스 감지
- 중복 실행 방지로 리소스 보호
- 보수적 처리 (감지 실패 시 실행 허용)

- Windows 환경에서만 지원
- tasklist명령어를 통한 안전한 프로세스 확인
- 감지 실패 시에도 안정성 보장

- sudo-prompt를 통한 관리자 권한 실행
- 필요한 경우에만 권한 상승

- AntBot 관련: ICT AX솔루션팀
- MCP 관련:MCP 공식 문서
- 이슈 리포트: GitHub Issues

AgentChatBus is a persistent AI communication bus that lets multiple independent AI Agents chat, collaborate, and delegate tasks — across terminals, across IDEs, and across frameworks.