Anki MCP 서버

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

특징

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

Related MCP server: Anki MCP Server

필수 조건

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

설치

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

용법

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

사용 가능한 도구

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

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

예시

새로운 덱 만들기

{ "name": "createDeck", "arguments": { "name": "My New Deck" } }

메모 추가

{ "name": "addNote", "arguments": { "deckName": "My New Deck", "modelName": "Basic", "fields": { "Front": "What is the capital of France?", "Back": "Paris" }, "tags": ["geography", "europe"] } }

검색 노트

{ "name": "searchNotes", "arguments": { "query": "deck:\"My New Deck\" tag:geography" } }

구성

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

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

문제 해결

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