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 라이센스