anki-mcp-서버

다른 언어로 읽어보세요: 영어 , 한국어

Claude와 Anki를 연결하는 MCP(Model Context Protocol) 서버를 사용하면 자연어를 사용하여 플래시카드를 쉽게 만들 수 있습니다.

소개

anki-mcp-server는 Claude와 Anki 앱 간의 연결고리 역할을 하여 두 앱 간의 소통을 가능하게 합니다. 이를 통해 Claude에게 자연어 명령을 제공하여 Anki 플래시카드를 만들고 관리할 수 있습니다. 예를 들어, "내 일본어 카드에 쉬운 일본어 어휘 카드를 추가해 주세요"라고 요청하면 Claude가 자동으로 적절한 카드를 생성합니다.

요구 사항

Python 3.8 이상
Anki 2.1.x 이상
AnkiConnect 애드온
Claude Desktop(또는 Claude API에 액세스할 수 있는 환경)

설치

1. Anki 및 AnkiConnect 설정

Anki를 설치하세요.
AnkiConnect 애드온을 설치하세요:
- Anki를 실행하고 상단 메뉴에서 Tools > Add-ons > Get Add-ons 선택하세요.
- 코드 2055492159 입력하고 '확인'을 클릭하세요.
- Anki를 다시 시작하세요

2. anki-mcp-server 설치

지엑스피1

구성

클로드 데스크탑 설정

MCP 서버를 등록하려면 Claude Desktop 구성 파일을 수정하세요.

Claude Desktop 구성 파일 위치:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- 리눅스: ~/.config/Claude/claude_desktop_config.json
구성 파일에 다음 내용을 추가합니다.

{
  "mcpServers": {
    "anki-mcp": {
      "command": "python",
      "args": ["path/anki_server.py"],
      "env": {}
    }
  }
}

path/anki_server.py anki_server.py 파일의 절대 경로로 바꾸세요.

사용 방법

Anki 애플리케이션을 실행하고 백그라운드에서 계속 실행하세요.
Claude Desktop을 실행합니다.
Claude에게 다음과 같은 자연어 명령을 내릴 수 있습니다.

예제 명령

"내 일본어 카드에 쉬운 일본어 어휘 카드를 추가하세요"
"영어 단어 'perseverance'의 의미와 예문을 담은 카드를 만들어 보세요"
"오늘 배운 프로그래밍 개념을 카드로 요약해 보세요"
"역사 타임라인 카드 5장 만들기"

클로드는 이러한 요청을 해석하고 MCP 서버를 통해 Anki에서 적절한 카드를 생성합니다.

주요 특징

카드 생성 기능

기본 질문-답변 형식 카드 생성
언어 학습 카드 만들기(단어, 의미, 예문)
자동 태그 추가
여러 덱에 카드 추가

데크 관리 기능

사용 가능한 데크 목록 보기
새로운 덱을 만드세요
특정 덱에서 카드 검색

문제 해결

연결 문제

Anki가 실행 중인지 확인하세요 . MCP 서버와 통신하려면 Anki가 실행 중이어야 합니다.
AnkiConnect 확인 : AnkiConnect가 제대로 설치되었는지 확인하세요. 웹 브라우저에서 http://localhost:8765 방문하여 "AnkiConnect v.6" 메시지가 표시되는지 확인하세요.
방화벽 설정 : Windows 사용자는 Anki에 대한 방화벽 액세스를 허용해야 할 수 있습니다.

MCP 서버 문제

로그 확인 : 문제가 발생하면 서버 로그에서 오류 메시지를 확인하세요.
다시 시작 : 문제가 지속되면 Anki, Claude Desktop 및 MCP 서버를 다시 시작해 보세요.

확장 및 기여

프로젝트에 기여하고 싶으시다면 GitHub 저장소를 포크하고 풀 리퀘스트를 제출해 주세요. 다음 분야의 기여를 환영합니다.

새로운 카드 유형 지원
향상된 언어 지원
인터페이스 개선
문서 개선

특허

이 프로젝트는 MIT 라이선스에 따라 배포됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

연락하다

문제나 질문이 있으시면 GitHub 이슈를 통해 문의해 주세요.

Anki MCP Server

Integrations