Anki MCP 서버

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

기능

도구

• list_decks - 사용 가능한 모든 Anki 덱 목록 표시

• create_deck - 새로운 Anki 덱 생성

• create_note - 새로운 노트 생성 (기본 또는 빈칸 채우기)

• batch_create_notes - 여러 노트를 한 번에 생성

• search_notes - Anki 쿼리 구문을 사용하여 노트 검색

• get_note_info - 노트에 대한 상세 정보 가져오기

• update_note - 기존 노트 업데이트

• delete_note - 노트 삭제

• list_note_types - 사용 가능한 모든 노트 유형 목록 표시

• create_note_type - 새로운 노트 유형 생성

• get_note_type_info - 노트 유형의 상세 구조 가져오기

리소스

• anki://decks/all - 사용 가능한 덱의 전체 목록

• anki://note-types/all - 사용 가능한 모든 노트 유형 목록

• anki://note-types/all-with-schemas - 모든 노트 유형에 대한 상세 구조 정보

• anki://note-types/{modelName} - 특정 노트 유형에 대한 상세 구조 정보

Related MCP server: Anki MCP Server

사전 요구 사항

1. 시스템에 Anki가 설치되어 있어야 합니다.

2. Anki에 AnkiConnect 애드온이 설치되어 있어야 합니다.

구성

데스크톱 확장 프로그램(.mcpb)을 통한 설치

이 저장소는 Anthropic 데스크톱 확장 프로그램(MCPB)을 지원합니다. Claude Desktop에서 이 서버를 사용하는 가장 쉬운 방법은 패키징된 .mcpb 번들을 설치하는 것입니다.

1. 제공된 스크립트를 사용하여 로컬에서 .mcpb 파일을 생성합니다:

npm run pack

2. Claude Desktop 설정 → 확장 프로그램(Extensions)을 열고 생성된 .mcpb 파일을 드래그한 다음 설치를 클릭합니다.

이 과정은 manifest.json을 검증하고 위와 같이 설치할 수 있는 .mcpb 아카이브를 출력합니다. Anthropic의 발표에서 데스크톱 확장 프로그램에 대해 자세히 알아보세요: Desktop Extensions: One-click MCP server installation for Claude Desktop.

Claude Desktop에서 사용

claude_desktop_config.json에 서버를 추가합니다:

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server"]
    }
  }
}

사용자 지정 AnkiConnect 포트 사용

AnkiConnect가 다른 포트에서 실행 중인 경우 --port 매개변수를 사용하여 지정할 수 있습니다:

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server", "--port", "8080"]
    }
  }
}

Cline을 위한 구성

VSCode 설정 파일인 cline_mcp_settings.json 내의 Cline MCP 설정 파일에 서버를 추가합니다.

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server"]
    }
  }
}

사용자 지정 AnkiConnect 포트 사용

Cline의 경우에도 사용자 지정 포트를 지정할 수 있습니다:

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server", "--port", "8080"]
    }
  }
}

에이전트 스킬 (Claude Code)

Anki 스킬을 설치하여 Claude Code에 모든 Anki 도구 및 워크플로우에 대한 내장 지식을 제공하세요:

npx skills add nailuoGG/anki-mcp-server@anki

설치가 완료되면 Claude Code는 플래시카드 생성, 덱 관리 또는 노트 일괄 가져오기를 요청할 때 자동으로 해당 스킬을 사용합니다.

참고: .mcpb 패키징 버전을 MCP 서버로 사용하지 마십시오. Electron 메타데이터를 stdout으로 출력하여 MCP stdio 프로토콜을 손상시킵니다. 대신 npx -y anki-mcp-server를 사용하십시오.

개발

데스크톱 확장 프로그램(.mcpb) 패키징

Claude Desktop을 위한 배포 가능한 데스크톱 확장 프로그램 번들을 생성합니다:

npm run pack

이 명령은 프로젝트를 빌드하고 현재 저장소에서 .mcpb 아카이브를 생성하며 manifest.json을 검증합니다. Claude Desktop의 확장 프로그램 설정으로 드래그하여 테스트하십시오. 참조: Desktop Extensions: One-click MCP server installation for Claude Desktop.

MCP 레지스트리에 게시

이 서버는 새 버전이 릴리스될 때 MCP 레지스트리에 자동으로 게시됩니다. 게시 프로세스에는 다음이 포함됩니다:

1. 자동화된 CI/CD: GitHub Actions가 성공적인 릴리스 시 NPM과 MCP 레지스트리에 자동으로 게시합니다.

2. 스키마 검증: server.json 파일은 게시 전에 MCP 스키마에 대해 검증됩니다.

3. 버전 동기화: package.json, manifest.json, server.json 간의 버전이 동기화됩니다.

4. 포괄적인 테스트: 게시 전 다중 버전 Node.js 테스트, 린팅 및 검증을 수행합니다.

5. 베타 지원: 새로운 기능 테스트를 위한 자동화된 베타 릴리스를 지원합니다.

수동 검증

로컬에서 MCP 서버 구성을 검증할 수 있습니다:

npm run validate-mcp

이 명령은 최신 MCP 스키마를 다운로드하고 server.json 파일을 검증합니다.

수동 게시

수동으로 게시해야 하는 경우 MCP Publisher CLI를 사용할 수 있습니다:

# Install MCP Publisher
curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.1.0/mcp-publisher_1.1.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
chmod +x mcp-publisher
sudo mv mcp-publisher /usr/local/bin/

# Login to MCP Registry
mcp-publisher login github-oidc

# Publish to MCP Registry
mcp-publisher publish

설정

1. 종속성 설치:

npm install

2. 서버 빌드:

npm run build

3. 자동 재빌드를 포함한 개발:

npm run watch

테스트

테스트 모음 실행:

npm test

다음 항목에 대한 테스트를 실행합니다:

• 서버 초기화

• AnkiConnect 통신

• 노트 작업 (생성/읽기/업데이트/삭제)

• 덱 관리

• 오류 처리

디버깅

MCP 서버는 stdio를 통해 통신하므로 MCP Inspector 사용을 권장합니다:

npm run inspector

다음 작업을 위한 브라우저 기반 인터페이스를 제공합니다:

• MCP 메시지 모니터링

• 도구 호출 테스트

• 서버 로그 보기

• 통신 문제 디버깅

사용 예시

1. 새로운 덱 생성:

Create a new Anki deck called "Programming"

2. 기본 카드 추가:

Create an Anki card in the "Programming" deck with:
Front: What is a closure in JavaScript?
Back: A closure is the combination of a function and the lexical environment within which that function was declared.

3. 빈칸 채우기 카드 추가:

Create a cloze card in the "Programming" deck with:
Text: In JavaScript, {{c1::const}} declares a block-scoped variable that cannot be {{c2::reassigned}}.

기여

1. 저장소 포크

2. 기능 브랜치 생성

3. 테스트 실행: npm test

4. 풀 리퀘스트 제출

스타 기록

크레딧

아이콘 제공: macOS Icons

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일을 참조하십시오.