kyaukyuai/almanac

almanac은(는) 무엇을 하나요?

도메인별 최신 지식 표면을 CLI 도구, MCP 서버, Claude Code 스킬로 컴파일합니다.

개요

kyaukyuai/almanac은 특정 도메인에 대한 지식을 수집, 정리, 최신 상태로 유지하여 개발자와 AI 에이전트가 쉽게 활용할 수 있게 해주는 도구입니다. 이 프로젝트는 정적 문서의 한계를 극복하고, 항상 최신 정보를 반영하는 동적 지식 표면을 제공합니다.

주요 기능

• 도메인별 지식 컴파일: 특정 주제나 도메인에 대한 정보를 수집하고 구조화합니다.
• 신선도 유지: 자동 업데이트 메커니즘을 통해 지식이 항상 최신 상태를 유지합니다.
• 다양한 출력 형식:
  • CLI 도구: 터미널에서 직접 지식을 검색하고 활용할 수 있습니다.
  • MCP 서버: AI 에이전트가 MCP 프로토콜을 통해 지식에 접근할 수 있습니다.
  • Claude Code 스킬: Claude Code 내에서 직접 사용 가능한 스킬 형태로 제공됩니다.

지원 플랫폼

• Claude Code
• Cursor
• Codex
• 기타 MCP 지원 AI 도구

사용 방법

1. 설치:

# npm을 통한 설치
git clone https://github.com/kyaukyuai/almanac.git
cd almanac
npm install

2. 설정: 원하는 도메인에 대한 설정 파일을 수정합니다.

3. 실행:

# CLI 도구로 실행
npm run start -- --domain=your-domain

# MCP 서버로 실행
npm run serve:mcp

MCP 서버 설정

Claude Code와 함께 사용하려면 claude.json에 MCP 서버를 추가하세요:

{
  "mcpServers": {
    "almanac": {
      "command": "node",
      "args": ["path/to/almanac/mcp-server.js"],
      "env": {
        "ALMANAC_DOMAIN": "your-domain"
      }
    }
  }
}

예시

도메인별 지식을 원하는 대로 컴파일할 수 있습니다. 예를 들어:

• kubernetes: 쿠버네티스 최신 기능 및 모범 사례
• aws-services: AWS 서비스별 업데이트 및 가이드
• python-libraries: 인기 파이썬 라이브러리 API 문서

기여

프로젝트에 기여하려면 GitHub 저장소를 방문하세요: kyaukyuai/almanac

라이선스

MIT

관련 프로젝트

• Model Context Protocol (MCP) - AI 에이전트와 도구 간 표준화된 통신 프로토콜
• Claude Code Skills - Claude Code 확장 스킬
• Official CLI Documentation - Claude Code CLI 공식 문서