mcp-ankiconnect MCP 서버

MCP를 통해 AnkiConnect와 Claude 대화를 연결하여 "오늘의 플래시카드를 살펴보자" 또는 "이것에 대한 플래시카드를 만들어보자"처럼 분산 반복을 쉽게 만드세요.

구성 요소

도구

서버는 세 가지 도구를 구현합니다.

• num_cards_due_today : 오늘 만료되는 카드 수를 가져옵니다.

  • 특정 데크로 필터링하기 위한 선택적 deck 인수

  • 모든 덱 또는 지정된 덱에서 만료된 카드 수를 반환합니다.

• get_due_cards : 검토 예정인 카드를 가져옵니다.

  • 카드 수를 제어하기 위한 선택적 limit 인수(기본값: 5)

  • 특정 데크로 필터링하기 위한 선택적 deck 인수

  • 오늘의 카드만 표시하려면 선택 사항인 today_only 인수(기본값: true)를 사용합니다.

  • 질문과 답변이 포함된 XML 형식의 카드를 반환합니다.

• submit_reviews : 검토된 카드에 대한 답변 제출

  • card_id 와 rating 사용하여 reviews 목록을 가져옵니다.

  • 평가: "잘못됨", "어려움", "좋음", "쉬움"

  • 제출된 리뷰의 확인을 반환합니다.

Related MCP server: Anki MCP Server

구성

필수 조건

• Anki는 AnkiConnect 플러그인 (플러그인 ID 2055492159)이 설치된 상태에서 실행해야 합니다. Mac에서는 AppSleep 기능으로 인해 AnkiConnect가 느려질 수 있으므로 Anki에서 해당 기능을 비활성화하세요. 비활성화하려면 터미널에서 다음 명령어를 실행하세요.

  지엑스피1

설치

빠른 시작

1. Anki에 AnkiConnect 플러그인을 설치하세요:

   • 도구 > 추가 기능 > 추가 기능 받기...

   • 코드 입력: 2055492159

   • Anki를 다시 시작하세요

2. Claude Desktop 구성:

   MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

   다음 구성을 추가합니다.

   {
     "mcpServers": {
       "mcp-ankiconnect": {
         "command": "uv",
         "args": ["run", "--with", "mcp-ankiconnect", "mcp-ankiconnect"]
       }
     }
   }

3. Anki와 Claude 데스크톱을 다시 시작하세요

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해 MCP Inspector 사용을 강력히 권장합니다. 먼저 저장소를 복제하고 종속성을 설치하세요.

git clone https://github.com/samefarrar/mcp-ankiconnect.git
cd mcp-ankiconnect
uv sync

mcp CLI를 통해 MCP Inspector를 실행할 수 있습니다.

uv run mcp dev mcp_ankiconnect/server.py

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.