cueapi-mcp

Name: cueapi-mcp
Author: cueapi

CueAPI를 위한 공식 Model Context Protocol 서버입니다. CueAPI는 AI 에이전트를 위한 오픈 소스 실행 책임 원시 요소(execution accountability primitive)입니다.

MCP가 활성화된 어시스턴트(Claude Desktop, Cursor, Zed 또는 기타 MCP 호스트)에게 에이전트 작업 예약, 실행 기록 가져오기, 증거 기반 결과 보고서로 루프 닫기 기능을 대화 내에서 직접 제공하세요.

목적

CueAPI는 에이전트의 조용한 실패를 방지합니다. 모든 예약된 실행은 사이클이 종료되기 전에 외부 ID, 결과 URL 또는 아티팩트와 같은 실제 발생 결과에 대한 증거를 반환해야 합니다. 이 MCP 서버는 해당 원시 요소를 에이전트에게 직접 노출하여, 에이전트가 후속 작업을 스스로 예약하고 증거와 함께 결과를 보고할 수 있도록 합니다.

설치

npm install -g @cueapi/mcp
# or use via npx (no install):
npx -y @cueapi/mcp

설정 (Claude Desktop)

Claude Desktop 설정 파일(~/Library/Application Support/Claude/claude_desktop_config.json, macOS 기준)에 다음을 추가하세요:

{
  "mcpServers": {
    "cueapi": {
      "command": "npx",
      "args": ["-y", "@cueapi/mcp"],
      "env": {
        "CUEAPI_API_KEY": "cue_sk_..."
      }
    }
  }
}

cueapi.ai에서 API 키를 생성하세요. 자체 호스팅을 하시나요? CUEAPI_API_KEY와 함께 CUEAPI_BASE_URL을 설정하세요.

설정 (Cursor / Zed / 기타 호스트)

stdio 서버를 지원하는 모든 MCP 호스트에서 실행할 수 있습니다. 호스트를 cueapi-mcp 바이너리로 지정하고 환경 변수에 CUEAPI_API_KEY를 전달하세요.

노출된 도구

도구	기능
`cueapi_create_cue`	반복(cron) 또는 일회성(`at`) 큐 생성
`cueapi_list_cues`	상태별로 필터링하여 큐 목록 조회
`cueapi_get_cue`	단일 큐에 대한 세부 정보 가져오기
`cueapi_pause_cue`	큐를 일시 중지하여 실행 중단
`cueapi_resume_cue`	일시 중지된 큐 재개
`cueapi_delete_cue`	큐 영구 삭제
`cueapi_list_executions`	큐/상태별로 필터링하여 과거 실행 목록 조회
`cueapi_report_outcome`	증거(외부 ID / URL)와 함께 일회성 결과 보고

대화 예시

사용자: 매일 오전 9시에 내 웹훅으로 요약 정보를 게시하는 작업을 예약해 줘.
어시스턴트 (cueapi_create_cue 사용): 큐 cue_abc123이 생성되었습니다. 첫 실행은 내일 오전 9시(UTC)입니다.
사용자: 마지막으로 실행된 5번의 기록을 보여줘.
어시스턴트 (cueapi_list_executions 사용): ...

개발

npm install
npm test        # vitest smoke tests for the tool surface
npm run build   # compile TypeScript to dist/
npm run dev     # run the server locally with tsx