🧠 안키 MCP

AI로 Anki 플래시카드 경험을 혁신하세요! 이 MCP(모델 컨텍스트 프로토콜) 서버는 Claude와 같은 AI 도우미와 Anki 플래시카드 컬렉션을 연결하여 학습 자료에 대한 자연스러운 대화를 가능하게 합니다.

🚀 무엇을 할 수 있나요?

여러분의 플래시 카드 컬렉션 전체를 알고 다음과 같은 일을 할 수 있는 AI 튜터가 있다고 상상해 보세요.

📚 대화형 학습

• "3일 동안 못 본 일본어 어휘 퀴즈 좀 해주세요"

• "내 의료 카드 덱에서 어려운 카드로 나를 시험해 봐"

• "최근에 내가 어려움을 겪고 있는 카드를 보여주세요"

✨ 스마트 콘텐츠 제작

• "다이어그램을 활용한 광합성에 대한 플래시카드 만들기"

• "이 PDF 장을 간격 반복 카드로 바꾸세요"

• "내 강의 노트에서 빈칸 삭제 카드 생성"

🔍 강력한 분석

• "어떤 주제가 가장 어려움을 겪고 있나요?"

• "지난 한 달 동안의 공부 패턴을 보여주세요"

• "다양한 카드 유형에 대한 유지율은 어떻게 되나요?"

🎯 대량 작업

• "내 모든 화학 카드에 '시험 준비' 태그를 달아주세요."

• "보존률이 낮은 카드를 집중 검토 덱으로 옮기세요"

• "내 덱에서 중복된 카드를 찾아 수정하세요"

Related MCP server: mcp-v8

🎯 특징

• 전체 Anki 통합 : 115개의 AnkiConnect API 메소드를 통해 데크, 카드, 메모 및 통계에 대한 완전한 액세스

• 대화형 인터페이스 : AI 어시스턴트를 통한 자연어 명령

• 대량 작업 : 수천 장의 카드를 한 번에 효율적으로 관리

• 실시간 통계 : 학습 진행 상황에 대한 통찰력을 얻으세요

• 미디어 지원 : 카드의 이미지, 오디오 및 기타 미디어를 처리합니다.

• 고급 쿼리 : 복잡한 검색 기준을 사용하여 카드 찾기

• 유형 안전성 : 포괄적인 오류 처리를 갖춘 완전한 유형화된 API

🛠 기술 스택

• Node.js : 런타임 환경 (18세 이상 필수)

• TypeScript : 유형 안전성 및 개발자 경험

• MCP SDK : 모델 컨텍스트 프로토콜 구현

• yanki-connect : 🙏 완전 유형화되고 동형인 AnkiConnect API 클라이언트

• tsup : 빠른 TypeScript 번들러

• PNPM : 효율적인 패키지 관리자

이 통합을 지원하는 강력한 AnkiConnect 인터페이스를 제공한 yanki-connect 라이브러리에 특별히 감사드립니다!

📋 필수 조건

1. Anki 설치

아직 Anki를 다운로드하지 않았다면 지금 설치하세요.

2. AnkiConnect 플러그인 설치

1. Anki 열기

2. 도구 → 애드온으로 이동

3. 추가 기능 받기...를 클릭하세요.

4. 코드 입력: 2055492159

5. Anki를 다시 시작하세요

📋 버전 요구 사항: 이 서버는 완벽한 호환성을 위해 AnkiConnect 버전 25.2.25.0 이상(2025년 2월 25일 출시)이 필요합니다. 대부분의 기능은 이전 버전에서도 작동하지만, 최상의 환경을 위해 업데이트하는 것을 권장합니다.

3. AnkiConnect 구성(선택 사항)

AnkiConnect는 바로 사용할 수 있지만 설정을 사용자 지정할 수 있습니다.

1. 도구 → 애드온으로 이동

2. AnkiConnect를 선택하고 구성을 클릭하세요.

3. 대부분의 사용자에게는 기본 설정이 잘 작동할 것입니다.

🚀 빠른 시작

옵션 1: Claude Desktop과 함께 사용(권장)

1. 패키지를 설치하세요

   지엑스피1

2. Claude Desktop 구성

   Claude Desktop 구성 파일을 편집하세요.

   macOS : ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows : %APPDATA%\Claude\claude_desktop_config.json

   다음 구성을 추가합니다.

   {
     "mcpServers": {
       "anki": {
         "command": "anki-mcp",
         "args": []
       }
     }
   }

3. Claude Desktop을 다시 시작하세요

4. 지금 사용을 시작하세요!

   • AnkiConnect가 활성화된 상태에서 Anki가 실행 중인지 확인하세요.

   • Claude에게 물어보세요: "내 Anki 덱 보여줘" 또는 "5장의 카드로 퀴즈 풀어줘"

💡 전문가 팁: 클로드에게 "내 Anki 덱이 몇 개나 있어?" 또는 "내 가장 큰 덱에는 무엇이 들어있어?" 와 같은 간단한 질문을 해서 설정을 테스트해 볼 수 있습니다.

옵션 2: 개발 설정

1. 저장소를 복제합니다

   git clone https://github.com/arielbk/anki-mcp.git
   cd anki-mcp

2. 종속성 설치

   pnpm install

3. 프로젝트를 빌드하세요

   pnpm build

4. 서버 테스트

   # Use the MCP inspector to test functionality
   pnpm inspect

옵션 3: 다른 MCP 클라이언트와 함께 사용

이 서버는 모든 MCP 호환 클라이언트와 호환됩니다. 또한 다음 클라이언트와도 호환됩니다.

• MCP Inspector : 대화형 디버깅 도구

• 클라인 : AI 코딩을 위한 VS 코드 확장

• 사용자 정의 MCP 클라이언트 : MCP SDK를 사용하여 사용자 정의 MCP 클라이언트를 구축하세요

stdio 전송의 경우 다음을 실행합니다.

node dist/index.js

🎮 사용 예시

Claude Desktop을 구성하면 다음과 같은 자연스러운 대화를 나눌 수 있습니다.

📖 스터디 세션

You: "I have a Japanese exam tomorrow. Can you quiz me on Hiragana cards I haven't reviewed in a week?"

Claude: I'll find your Hiragana cards that need review and start a quiz session...

📝 콘텐츠 제작

You: "Create flashcards for the major battles of World War II with dates and significance"

Claude: I'll create comprehensive flashcards covering the key WWII battles...

📊 학습 분석

You: "How am I doing with my medical terminology deck? Show me my weak areas."

Claude: Let me analyze your performance on the medical terminology deck...

🏷️ 조직

You: "Tag all cards about cardiovascular system with 'cardiology' and move them to my MCAT prep deck"

Claude: I'll help you organize those cards...

🔧 사용 가능한 도구 및 리소스

이 MCP 서버는 다음 기능을 통해 Anki 컬렉션에 대한 포괄적인 액세스를 제공합니다.

📚 데크 관리

• 통계를 포함한 모든 데크 나열

• 새로운 덱을 만드세요

• 데크 이름 변경 및 삭제

• 데크 구성 가져오기

🗂️ 카드 운영

• 검색 기준으로 카드 찾기

• 카드 답변하기(리뷰 시뮬레이션)

• 카드 정보 및 통계를 얻으세요

• 카드 정지/정지 해제

• 대량 카드 작업

📝 노트 관리

• 사용자 정의 필드로 새 메모 추가

• 기존 노트 업데이트

• 메모 삭제

• 검색어로 노트 찾기

• 대량 메모 작업

📊 통계 및 분석

• 데크 통계 및 성능 지표

• 카드 편의성 및 간격 데이터

• 역사와 패턴을 검토하세요

• 학습 진행 상황 통찰력

🎨 미디어 & 모델

• 노트 유형 및 필드 정의에 액세스

• 미디어 파일 관리

• 템플릿 사용자 정의 지원

🔍 고급 기능

• Anki의 검색 구문을 사용한 복잡한 검색 쿼리

• 효율성을 위한 일괄 작업

• Anki와 실시간 동기화

• 오류 처리 및 검증

• 기능(카드, 데크, 노트, 모델, 통계, 미디어 등)별로 그룹화된 정리된 API 메서드

• 전체 유형 안전성을 갖춘 115개 AnkiConnect API 메서드에 직접 액세스

🛠 개발

# Run in development mode with auto-reloading
pnpm dev

# Lint the code
pnpm lint

# Format the code
pnpm format

# Test with MCP inspector
pnpm inspect

🔧 구성

AnkiConnect 설정

서버는 기본적으로 localhost:8765 의 AnkiConnect에 연결됩니다. AnkiConnect 구성을 사용자 지정했다면 연결 설정을 조정해야 할 수도 있습니다.

중요 : MCP 서버를 사용하기 전에 Anki가 실행 중이고 AnkiConnect가 설치되어 있는지 확인하세요. AnkiConnect에 액세스할 수 없으면 서버 연결에 실패합니다.

💡 참고: 기본 yanki-connect 라이브러리는 macOS에서 Anki 자동 실행을 지원하지만, 현재 MCP 서버 구성에는 이 기능이 제공되지 않습니다. Anki를 수동으로 실행해야 합니다.

Claude Desktop 고급 구성

고급 사용자의 경우 추가 매개변수를 전달할 수 있습니다.

{
  "mcpServers": {
    "anki": {
      "command": "anki-mcp",
      "args": ["--verbose"],
      "env": {
        "ANKI_CONNECT_HOST": "localhost",
        "ANKI_CONNECT_PORT": "8765"
      }
    }
  }
}

문제 해결

일반적인 문제:

• "AnkiConnect에 연결하지 못했습니다" : Anki가 실행 중이고 AnkiConnect 플러그인이 설치되어 있는지 확인하세요.

• "덱을 찾을 수 없습니다" : Anki에 최소한 하나의 덱이 있는지 확인하세요.

• Claude가 응답하지 않습니다 . 구성 변경 후 Claude Desktop을 다시 시작하세요.

• 권한 오류 : npm list -g @arielbk/anki-mcp 사용하여 글로벌 npm 설치가 올바르게 작동하는지 확인하세요.

🤝 기여하기

여러분의 참여를 환영합니다!

1. 저장소를 포크하세요

2. 기능 브랜치 생성

3. 변경 사항을 만드세요

4. 해당되는 경우 테스트를 추가하세요

5. 풀 리퀘스트 제출

📜 라이센스

MIT - 자세한 내용은 LICENSE 파일을 참조하세요.

🙏 감사의 말

• yanki-connect - AnkiConnect를 위한 뛰어난 TypeScript 클라이언트

• AnkiConnect - Anki 자동화를 가능하게 하는 플러그인

• 모델 컨텍스트 프로토콜 - 원활한 AI 통합 지원

AI 기반 대화로 플래시카드 경험을 혁신하세요! 🚀