안키 MCP

🧠 안키 MCP

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

🚀 무엇을 할 수 있나요?

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

📚 대화형 학습

"3일 동안 못 본 일본어 어휘 퀴즈 좀 해주세요"
"내 의료 카드 덱에서 어려운 카드로 나를 시험해 봐"
"최근에 내가 어려움을 겪고 있는 카드를 보여주세요"

✨ 스마트 콘텐츠 제작

"다이어그램을 활용한 광합성에 대한 플래시카드 만들기"
"이 PDF 장을 간격 반복 카드로 바꾸세요"
"내 강의 노트에서 빈칸 삭제 카드 생성"

🔍 강력한 분석

"어떤 주제가 가장 어려움을 겪고 있나요?"
"지난 한 달 동안의 공부 패턴을 보여주세요"
"다양한 카드 유형에 대한 유지율은 어떻게 되나요?"

🎯 대량 작업

"내 모든 화학 카드에 '시험 준비' 태그를 달아주세요."
"보존률이 낮은 카드를 집중 검토 덱으로 옮기세요"
"내 덱에서 중복된 카드를 찾아 수정하세요"

🎯 특징

전체 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 플러그인 설치

Anki 열기
도구 → 애드온으로 이동
추가 기능 받기...를 클릭하세요.
코드 입력: 2055492159
Anki를 다시 시작하세요

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

3. AnkiConnect 구성(선택 사항)

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

도구 → 애드온으로 이동
AnkiConnect를 선택하고 구성을 클릭하세요.
대부분의 사용자에게는 기본 설정이 잘 작동할 것입니다.

🚀 빠른 시작

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

패키지를 설치하세요지엑스피1
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": [] } } }
Claude Desktop을 다시 시작하세요
지금 사용을 시작하세요!
- AnkiConnect가 활성화된 상태에서 Anki가 실행 중인지 확인하세요.
- Claude에게 물어보세요: "내 Anki 덱 보여줘" 또는 "5장의 카드로 퀴즈 풀어줘"

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

옵션 2: 개발 설정

저장소를 복제합니다
git clone https://github.com/arielbk/anki-mcp.git cd anki-mcp
종속성 설치
pnpm install
프로젝트를 빌드하세요
pnpm build
서버 테스트
# 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 설치가 올바르게 작동하는지 확인하세요.

🤝 기여하기

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

저장소를 포크하세요
기능 브랜치 생성
변경 사항을 만드세요
해당되는 경우 테스트를 추가하세요
풀 리퀘스트 제출

📜 라이센스

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

🙏 감사의 말

yanki-connect - AnkiConnect를 위한 뛰어난 TypeScript 클라이언트
AnkiConnect - Anki 자동화를 가능하게 하는 플러그인
모델 컨텍스트 프로토콜 - 원활한 AI 통합 지원

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.