YMuskrat/arcticdb_mcp

arcticdb-mcp – ArcticDB에 대한 구조화된 액세스를 위한 MCP 서버

그것은 무엇인가 – arcticdb-mcp는 오픈 소스 시계열 및 버전 관리 데이터 스토어인 ArcticDB를 래핑하는 작은 Python 기반 서버입니다. 데이터베이스의 기능을 MCP(모델 컨텍스트 프로토콜) 클라이언트(예: Claude Desktop, Cursor, Windsurf 또는 Continue)에서 호출할 수 있는 도구 세트로 노출합니다. 실제로 이는 대화형 AI 어시스턴트가 사용자가 코드를 작성하지 않고도 ArcticDB의 데이터를 읽고, 쓰고, 버전을 관리하고, 쿼리할 수 있게 합니다.

왜 중요한가 – 최신 LLM 기반 어시스턴트는 대규모 버전 관리 데이터 세트(예: 시장 데이터, 센서 로그, 실험 결과)를 가져오거나 업데이트해야 하는 경우가 많습니다. arcticdb-mcp는 즉시 사용 가능하고 추적 가능한 API를 제공합니다:

• 완전한 감사 가능성을 위한 심볼별 버전 관리 및 스냅샷 지원.
• 페이지네이션 및 서버 측 슬라이싱을 제공하여 LLM의 제한된 토큰 창 내에서도 거대한 심볼을 검사할 수 있습니다.
• 간단한 stdio(데스크톱 MCP 클라이언트의 기본값) 또는 HTTP/SSE를 통해 작동하여 로컬 스크립트나 원격 서비스에 쉽게 포함할 수 있습니다.

주요 기능(49개 도구)

• 라이브러리 관리 – 라이브러리 나열, 생성, 삭제; 옵션 검사.
• 심볼 작업 – 심볼 읽기/쓰기/추가/업데이트/삭제; 헤드/테일 가져오기; 메타데이터 쿼리; 버전 나열.
• 배치 작업 – 단일 호출에서 여러 심볼에 동일한 작업 수행(예: write_batch).
• 스냅샷 – 명명된 스냅샷 생성, 나열/삭제, 스냅샷 시점의 심볼 읽기.
• 쿼리 도우미 – ArcticDB에서 직접 실행되는 필터, isin, 그룹화, 날짜 범위 및 리샘플링 작업.
• 유지 관리 – 심볼 목록 다시 로드/압축, 데이터 조각 모음, 이전 버전 정리.
• 페이지네이션 읽기 – read_symbol_page는 버전 고정 정보와 함께 행 슬라이스를 반환하여 일관된 다중 페이지 검색을 가능하게 합니다.

설치

# 권장 원라이너
uvx arcticdb-mcp
# 대안
pipx install arcticdb-mcp
pip install arcticdb-mcp   # Python ≥3.9 필요

실행

• StdIO(기본값) – ARCTICDB_URI=lmdb:///path/to/db python -m arcticdb_mcp
• HTTP/SSE – ARCTICDB_MCP_PORT=8000(또는 1-65535의 모든 포트)을 설정하고 동일한 명령을 시작합니다; 서버는 http://localhost:8000/sse에서 수신합니다.

구성 – 유일하게 필요한 설정은 ARCTICDB_URI이며, 다음을 가리킬 수 있습니다:

• 로컬 LMDB(lmdb:///path/to/db)
• AWS S3, Azure Blob 또는 모든 S3 호환 엔드포인트(자격 증명은 URI 쿼리 문자열로 전달됨)
• .env 파일도 사용할 수 있습니다.

일반적인 대화 프롬프트

라이브러리 finance에서 AAPL의 마지막 5개 행 표시
심볼을 업데이트하기 전에 finance의 스냅샷 생성
심볼 ES_intraday의 버전 나열
NVDA를 가격 > 500 및 거래량 >= 1000으로 필터링
ES_intraday를 5분으로 리샘플링하고 가격 평균, 거래량 합계 집계

어시스턴트는 이러한 자연어 요청을 적절한 도구 호출로 변환하고, 서버는 LLM이 응답에 포함할 수 있는 형식으로 데이터(또는 확인)를 반환합니다.

개발 – 리포지토리를 클론하고, 편집 가능 모드로 설치(pip install -e .)하고, 동일한 ARCTICDB_URI 환경 변수로 로컬에서 실행합니다. 빠른 무결성 검사를 위한 테스트 하네스(@modelcontextprotocol/inspector)가 제공됩니다.

로드맵 – 프로젝트는 기여자가 구현할 수 있는 몇 가지 미해결 기능(예: 단계적 데이터 처리, 관리 도구)을 나열합니다.

라이선스 – MIT.

---

결론 – arcticdb-mcp는 ArcticDB의 고성능 버전 관리 데이터 스토리지와 LLM 기반 어시스턴트 사이의 실용적인 다리이며, 완전한 추적성과 최소한의 스크립팅으로 데이터 중심 AI 워크플로우를 가능하게 합니다.