anki-mcp

Model Context Protocol (MCP) 기반의 경량 어댑터로, AI 어시스턴트(Claude Code, Hermes Agent 등)가 AnkiConnect를 통해 Anki 카드를 직접 만들고 관리할 수 있게 해 줍니다.

커스텀 AI 앱은 필요 없습니다. AI는 지능 계층으로 남고, 이 서버는 Anki로 연결하는 다리 역할만 합니다.

Claude Code / Hermes / ChatGPT
          │  MCP (stdio)
          ▼
    anki-mcp server
          │  AnkiConnect HTTP (localhost:8765)
          ▼
    Anki Desktop + AnkiConnect add-on
          │  sync
          ▼
       AnkiWeb ──► Anki mobile (iOS/Android)

기능

Related MCP server: Anki MCP Server

설정

1. Anki Desktop 설치

https://apps.ankiweb.net/에서 다운로드하여 설치하세요. 한 번 실행하고 AnkiWeb 계정과 동기화하여 모바일 동기화가 작동하게 하세요.

2. AnkiConnect 애드온 설치

AnkiConnect는 localhost:8765의 로컬 HTTP API를 통해 Anki를 노출합니다.

옵션 A — Anki 애드온 브라우저 (가장 쉬움):

1. Anki에서: 도구 → 애드온 → 애드온 받기…

2. 코드 **2055492159**를 입력하고 설치합니다.

옵션 B — 수동 (Git):

cd "$APPDATA/Anki2/addons21"           # Windows
# or: ~/.local/share/Anki2/addons21   (Linux)
# or: ~/Library/Application Support/Anki2/addons21  (macOS)

git clone --depth 1 https://github.com/FooSoft/anki-connect.git 2055492159
cd 2055492159
cp plugin/*.py plugin/*.json plugin/*.md .
rm -rf plugin tests .git 2>/dev/null

3. Anki를 다시 시작합니다. 실행 중인지 확인합니다:

curl -s http://127.0.0.1:8765 -X POST -d '{"action":"version","version":6}'
# → {"result": 6, "error": null}

3. MCP 서버 실행

pip install mcp
python server.py

서버는 stdio를 통해 MCP를 사용합니다. 도구가 작동하려면 Anki Desktop이 (AnkiConnect가 로드된 상태로) 실행 중이어야 합니다.

클라이언트에서 구성

Hermes Agent

~/.hermes/config.yaml에 추가하세요 (Windows에서는 %USERPROFILE%\AppData\Local\hermes\config.yaml):

mcp_servers:
  anki:
    command: python
    args:
      - /absolute/path/to/server.py
    timeout: 60
    connect_timeout: 30

그런 다음 세션 내에서 MCP를 다시 로드(/reload-mcp)하거나 다시 시작하세요. 도구는 mcp_anki_*로 나타납니다.

Claude Code

claude mcp add anki -- python /absolute/path/to/server.py

사용법

연결이 완료되면 AI에게 원하는 것을 말하기만 하면 됩니다:

"내 System Design 덱에 카드를 추가해 줘: 앞면 = '일관된 해싱이 왜 가상 노드를 사용하나요?', 뒷면 = '키를 더 균일하게 분산하기 위해서입니다.'"

"방금 논의한 중요한 개념들로 Anki 카드를 만들어 줘."

카드 생성 규칙 (AI 지침에 포함하세요)

• 카드당 하나의 개념.

• 회상(recall)이 필요한 질문을 선호하세요.

• 지나치게 긴 답변은 피하세요.

• 사소한 사실에 대한 카드는 만들지 마세요.

• 적절한 경우 클로즈(Cloze) 카드를 사용하세요.

• 출처/주제 태그를 추가하세요.

모바일 동기화

MCP로 생성된 카드는 동기화하기 전까지 Anki Desktop에 남아 있습니다. 동기화를 실행하세요:

• 수동: Anki → 동기화 (또는 Y 키), 또는

• AnkiConnect를 통해: curl -s http://127.0.0.1:8765 -X POST -d '{"action":"sync","version":6}'

그런 다음 Anki 모바일 앱을 동기화하여 새 카드를 가져오세요.

요구 사항

• Python 3.10+

• mcp 패키지 (pip install mcp)

• Anki Desktop (실행 중)

• AnkiConnect 애드온

라이선스

MIT