Anki MCP 서버

AnkiConnect를 통해 Anki에 연결하고 리치 태그가 지정된 카드를 검색하는 Claude Desktop용 MCP(Model Context Protocol) 서버입니다.

특징

AnkiConnect API를 통해 Anki에 연결
"거머리" 태그가 있는 카드를 검색합니다.
카드에 날짜가 찍힌 리뷰 태그를 추가합니다.
Claude가 분석할 수 있는 포괄적인 카드 데이터를 제공합니다.
Claude Desktop과 함께 사용 가능

필수 조건

Anki 설치 및 실행
Anki에 AnkiConnect 애드온 설치
Node.js와 npm

설치

이 저장소를 복제하세요:지엑스피1
종속성 설치:
npm install
프로젝트를 빌드하세요:
npm run build

구성

환경 변수를 사용하여 서버를 구성할 수 있습니다. 제공된 예제 파일을 복사하여 직접 구성을 생성하세요.

cp .env.example .env

그런 다음 .env 파일을 편집하여 설정을 사용자 정의합니다.

환경 변수	설명	기본값
`ANKI_CONNECT_URL`	Anki Connect API의 URL	`http://localhost:8765`
`ANKI_CONNECT_VERSION`	사용할 Anki Connect API 버전	`6`
`ANKI_MOCK_MODE`	테스트를 위해 모의 모드 활성화(참/거짓)	`false`

환경 변수가 설정되지 않으면 서버는 기본값을 사용합니다.

AnkiConnect에 대한 로컬 IP 주소 찾기

localhost 연결이 작동하지 않으면 컴퓨터의 로컬 IP 주소를 대신 사용해야 합니다. .env 파일을 다음과 같이 구성하세요.

ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765

로컬 IP 주소를 찾으려면:

macOS : 터미널을 열고 ifconfig 또는 ipconfig getifaddr en0 (WiFi의 경우)을 실행합니다.
Windows : 명령 프롬프트를 열고 ipconfig 실행합니다.
Linux : 터미널을 열고 ip addr show 또는 hostname -I 실행합니다.

출력에서 192.168.xx 또는 10.xxx 와 같은 IPv4 주소를 찾으세요.

테스트 구성

테스트를 위해 별도의 구성 파일 .env.test 가 제공됩니다.

cp .env.example .env.test

.env.test 편집하여 테스트별 값을 설정합니다.

ANKI_CONNECT_URL=http://localhost:8765
ANKI_CONNECT_VERSION=6
ANKI_MOCK_MODE=true

테스트 모드에서 실행하려면:

npm run start:test

용법

AnkiConnect가 설치되어 Anki가 실행 중인지 확인하세요.
MCP 서버를 실행합니다.
npm start

Claude Desktop 구성

Claude Desktop과 함께 이 MCP 서버를 사용하려면:

클로드 데스크톱 열기
다음 위치에 있는 Claude Desktop 구성 파일을 편집하세요.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- 리눅스: ~/.config/Claude/claude_desktop_config.json
mcpServers 섹션에 다음 구성을 추가합니다.

{
  "mcpServers": {
    "anki": {
      "command": "node",
      "args": ["path/to/anki-mcp-server/dist/index.js"]
    }
  }
}

"path/to/anki-mcp-server" 이 저장소를 복제한 실제 경로로 바꾸세요.

MCP 도구 사용

구성이 완료되면 Claude에서 다음 도구를 사용할 수 있습니다.

사용 예

Could you analyze my Anki leech cards and suggest ways to improve my study?

클로드는 MCP 서버를 사용하여 귀하의 흡혈 카드를 검색하여 분석합니다.

사용 가능한 도구

get_leech_cards

Anki에서 거머리로 태그된 카드를 검색합니다.

매개변수:

detailed (선택 사항, 부울, 기본값: true): 포괄적인 카드 데이터를 반환할지 아니면 ID만 반환할지 여부
count (선택 사항, 숫자): 반환할 무작위 카드의 수(기본값은 모든 카드)

태그_검토_카드

지정된 카드에 날짜가 적힌 "검토됨" 태그를 추가합니다. 이를 통해 Claude와 함께 검토한 카드를 추적할 수 있습니다.

매개변수:

card_ids (필수, 숫자 배열): 검토됨으로 태그 지정할 카드 ID 배열
custom_tag_prefix (선택 사항, 문자열, 기본값: "見直し"): 태그에 대한 사용자 정의 접두사

태그는見直し_YYYYMMDD 형식(또는 지정된 경우 사용자 정의 접두사)을 따릅니다.

Claude에서의 사용 예:

I've reviewed these cards, please tag them as reviewed: [1234567890, 1234567891]

문제 해결

"Anki에 연결할 수 없습니다" - Anki가 실행 중이고 AnkiConnect가 제대로 설치되어 있는지 확인하세요.
"거머리 카드를 찾을 수 없습니다" - Anki에 "거머리"로 태그된 카드가 없습니다.
localhost 연결 문제 - localhost 사용하여 연결할 수 없는 경우:
1. 구성 섹션에 설명된 대로 로컬 IP 주소를 찾으세요.
2. .env 파일을 업데이트하여 ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765 사용하세요.
3. AnkiConnect가 IP 주소에서 연결을 허용하도록 구성되어 있는지 확인하세요.
4. 이러한 변경 사항을 적용한 후 MCP 서버를 다시 시작하세요.
태그가 나타나지 않음 - tag_reviewed_cards 도구에 유효한 카드 ID를 제공하고 있는지 확인하세요.

테스트 모드

실제 Anki 데이터에 영향을 주지 않고 테스트하려면 모의 모드를 사용할 수 있습니다.

.env 파일에서 ANKI_MOCK_MODE=true 설정하거나 제공된 .env.test 파일을 사용하세요.
npm run start:test 로 서버를 실행하세요.

모의 모드에서는 서버가 Anki에 실제로 연결하지 않고 모든 Anki 작업을 시뮬레이션합니다. 이는 데이터 변경 위험 없이 Claude 통합을 테스트하는 데 유용합니다.

개발

핫 리로딩을 사용하여 개발 모드에서 서버를 실행하려면:

npm run dev

모의 모드가 활성화된 개발의 경우:

npm run dev:test

특허

MIT

Anki MCP Server

Integrations