Agentic Task Board

Agent를 위한 작업 관리 앱. MCP(Model Context Protocol) 서버와 웹 UI를 통해 작업을 관리할 수 있습니다.

기능

• 작업 관리: CRUD 작업 지원 (생성, 조회, 수정, 삭제)
• 상태 관리: todo, progress, done 상태 추적
• 에이전트 할당: 각 작업에 에이전트 할당 가능
• MCP 서버: Claude 같은 AI 도구에서 프로토콜을 통해 접근 가능
• 웹 UI: http://localhost:9090에서 작업 현황을 시각적으로 확인

• MCP 서버
• 웹 서버

프로젝트 구조

src/
  main.rs          -- 진입점: MCP 서버 + 웹 서버 동시 실행
  db.rs            -- DB 초기화, 커넥션 풀, SQL쿼리 함수
  mcp_server.rs    -- MCP ServerHandler 구현, 도구 정의
  web_server.rs    -- Axum 웹 서버: 라우트, HTML 렌더링

main.rs 구조

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // DB 초기화 (Arc<SqlitePool>)
    // tracing 초기화 (stderr로 - stdout은 MCP 전송용)
    // MCP 서버(stdio) + 웹 서버 동시 실행
}

설치

요구사항

• Rust 1.70 이상
• SQLite3

빌드

cargo build --release

사용법

1. 웹 UI 실행

cargo run [-- --no-mcp]

기본 포트는 9090이며, 환경 변수로 변경 가능합니다:

ATB_PORT=9090 cargo run

• GET / - 태스크 목록 HTML 페이지 (에이전트별 그룹, 상태별 색상)
• GET /api/tasks - JSON API
• 바인드: 127.0.0.1:9090 (환경변수 ATB_PORT로 변경 가능)

웹 브라우저에서 http://localhost:9090을 열어 작업 목록을 확인합니다.

index.html

외부 프로젝트에서 생성

2. MCP 서버로 사용

ATB는 MCP(Model Context Protocol) 서버로 실행되며, 표준 입출력을 통해 JSON-RPC 통신을 수행합니다.

MCP 도구

설정 예시 (Claude 설정)

.mcp.json 파일에 다음을 추가합니다:

{
  "mcpServers": {
    "Agentic Task Board": {
      "type": "stdio",
      "command": "/path/to/atb"
    }
  }
}

클로드가 실행되는 경로에 있어야 인식 함

데이터베이스

SQLite 데이터베이스는 프로젝트 디렉토리에 .atb.sqlite3 파일로 생성됩니다.

스키마:

CREATE TABLE tasks (
    id          INTEGER PRIMARY KEY AUTOINCREMENT,
    agent_name  TEXT,
    status      TEXT NOT NULL DEFAULT 'todo' CHECK(status IN ('todo', 'progress', 'done')),
    content     TEXT NOT NULL,
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
);

CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
CREATE INDEX IF NOT EXISTS idx_tasks_agent ON tasks(agent_name);

API 엔드포인트

GET /

작업 목록을 HTML 형식으로 반환합니다. 에이전트별로 그룹화되어 표시됩니다.

GET /api/tasks

모든 작업을 JSON 형식으로 반환합니다.

응답 예시:

[
  {
    "id": 1,
    "agent_name": "backend-agent",
    "status": "progress",
    "content": "API 엔드포인트 구현",
    "created_at": "2026-03-08T10:30:00",
    "updated_at": "2026-03-08T10:30:00"
  }
]

아키텍처

모듈 구조

• main.rs: 애플리케이션 진입점, 토키오 런타임 설정, 두 서버의 동시 실행
• models.rs: 데이터 모델 정의 (Task, 요청 구조체)
• db.rs: SQLx를 사용한 데이터베이스 작업
• mcp_server.rs: rmcp 기반 MCP 프로토콜 구현
• web.rs: Axum 기반 웹 서버 구현

동시성

• 웹 서버와 MCP 서버는 tokio::try_join!를 사용하여 동시에 실행됩니다.
• 데이터베이스 풀은 Arc<SqlitePool>로 공유되어 스레드 안전성을 보장합니다.

개발

테스트

cargo test
cargo clippy  # lint
cargo fmt     # format

기여

이슈 및 풀 리퀘스트를 환영합니다.