Anki MCP 서버

AnkiConnect API를 통해 LLM이 Anki 플래시카드 소프트웨어와 상호 작용할 수 있도록 하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

• Anki에서 새로운 덱을 만드세요
• 기존 데크에 메모 추가
• 사용 가능한 데크와 참고 모델을 나열하세요
• Anki의 검색 구문을 사용하여 노트 검색
• 노트 모델과 해당 필드에 대한 자세한 정보를 얻으세요
• 여러 개의 노트를 한 번에 대량으로 추가

필수 조건

• Node.js (v14 이상)
• AnkiConnect 애드온이 설치된 Anki
• 모델 컨텍스트 프로토콜 호환 클라이언트(Anthropic MCP 지원이 있는 Claude 등)

설치

1. AnkiConnect 애드온과 함께 Anki가 설치되어 있는지 확인하세요.
   • 도구 > 추가 기능 > 추가 기능 받기로 가서 코드 2055492159 입력하여 AnkiConnect를 설치하세요.
2. 이 저장소를 복제하세요:지엑스피1
3. 종속성 설치:
   npm install
4. 프로젝트를 빌드하세요:
   npm run build

용법

1. AnkiConnect가 활성화된 컴퓨터에서 Anki가 실행되고 있는지 확인하세요.
2. MCP 서버를 시작합니다.
   npm start
3. MCP 클라이언트(예: Claude)를 이 서버에 연결하세요.

사용 가능한 도구

서버는 MCP 클라이언트에 다음과 같은 도구를 제공합니다.

• listDecks : Anki의 모든 덱 목록을 가져옵니다.
• listModels : Anki의 모든 노트 모델/유형 목록을 가져옵니다.
• createDeck : Anki에서 새로운 덱을 만듭니다.
• getModel : 특정 노트 모델/유형에 대한 세부 정보를 가져옵니다.
• addNote : 데크에 단일 노트 추가
• addNotes : 여러 개의 노트를 한 번에 추가
• searchNotes : Anki의 검색 구문을 사용하여 노트를 검색합니다.

예시

새로운 덱 만들기

메모 추가

검색 노트

구성

서버 설정은 src/index.ts 의 config 객체에 있습니다. 다음을 수정할 수 있습니다.

• ankiConnectUrl : AnkiConnect API의 URL(기본값: http://localhost:8765 )
• apiVersion : AnkiConnect의 API 버전(기본값: 6 )
• defaultDeckName : 아무것도 지정하지 않으면 사용할 기본 데크(기본값: Default )

문제 해결

1. Anki에 연결할 수 없습니다
   • Anki가 실행 중인지 확인하세요
   • AnkiConnect 애드온이 설치되어 작동하는지 확인하세요.
   • AnkiConnect URL이 올바른지 확인하세요(기본값: http://localhost:8765 )
2. AnkiConnect의 권한 문제
   • 서버가 카드를 추가하려고 할 때 AnkiConnect에서 권한을 요청하는 메시지가 표시될 수 있습니다. Anki에서 팝업을 확인하세요.

특허

MIT 라이센스