🚀 MoltBot 구축 마스터 가이드

MoltBot은 Notion MCP와 통합하여 자동화된 테스트 및 빌드 환경을 제공하는 강력한 도구입니다. 이 가이드에서는 MoltBot의 설치부터 네트워크 설정, 아키텍처 이해, 그리고 향후 확장 계획까지 다루겠습니다.

💡 📋 목차: 1. 설치 | 2. 네트워크 설정 | 3. 아키텍처 이해 | 4. 관리 및 테스트 | 5. 향후 확장 계획

1. 설치 단계

MoltBot을 설치하기 위해서는 Linux PC (호스트)와 Node.js 환경이 필요합니다.

1
2
3
4
5
6
7
8

# 1. Node.js 설치
sudo apt update && sudo apt install -y nodejs npm

# 2. MoltBot 설치
npm install -g molt-bot

# 3. Notion MCP 연동 설정
notion-mcp connect --token <your-notion-token>

💡 ⚠️ 주의: Notion MCP를 연동하기 전에 Notion API 토큰을 발급받아야 합니다.

2. 네트워크 설정

MoltBot은 Linux PC (호스트)에서 실행되며, MoltBot Gateway를 통해 여러 서비스와 통신합니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 1. MoltBot Gateway 시작
molt-bot-gateway --port 3000

# 2. 네트워크 구성
# Linux PC (호스트)
#   |
#   +-- MoltBot Gateway (Port 3000)
#       |
#       +-- Notion MCP (데이터 저장/관리)
#       |
#       +-- Telegram (메시지 송수신)
#       |
#       +-- OpenCode (개발 환경 연동)
#       |
#       +-- Web 서비스 (Gateway Dashboard)

💡 💡 팁: 방화벽을 설정하려면 Linux PC의 방화벽에서 Port 3000을 허용해야 합니다.

3. 아키텍처 및 데이터 흐름

MoltBot은 이벤트 기반 아키텍처로 구성되어 있으며, 다음과 같은 데이터 흐름을 가집니다:

  # 전체 아키텍처 흐름:
Linux PC (호스트) |
  +-- MoltBot Gateway
      |
      +-- Notion MCP (데이터 저장/관리)
      |
      +-- Telegram (메시지 송수신)
      |
      +-- OpenCode (개발 환경 연동)
      |
      +-- Web 서비스 (Gateway Dashboard)

각 컴포넌트는 다음과 같은 역할을 수행합니다:

• MoltBot Gateway: API 요청 처리 및 서비스 간 중개
• Notion MCP: Notion 데이터베이스와의 연동 및 데이터 동기화
• Telegram: 사용자 메시지 송수신 및 알림
• OpenCode: IDE 통합 및 코드 생성 자동화

4. 관리 및 테스트

MoltBot을 효율적으로 관리하기 위해 다음과 같은 도구와 명령어를 제공합니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# MoltBot 상태 확인
molt-bot status

# 로그 확인
tail -f /var/log/molt-bot/molt-bot.log

# 재시작
systemctl restart molt-bot

# 설정 파일 확인
vi ~/.molt-bot/config.json

5. 향후 확장 계획

MoltBot은 지속적으로 확장되고 있으며, 다음과 같은 기능들이 추가될 예정입니다:

• 논문 관련 연구 확장
• 웹 서비스 기능 확장 (Gateway Dashboard)
• 개발 프로젝트 총괄 관리 시스템
• 추가 채널 연동 (Discord, Slack 등)
• 자동화 및 크론 작업 확장

MoltBot은 개발자들의 자동화된 작업 흐름을 최적화하고 있습니다. 위 가이드를 따라 설치 및 설정을 진행하면, 강력한 자동화 환경을 구축할 수 있습니다.

💡 📚 공식 문서: https://docs.molt.bot