AniList MCP 서버

AniList API와 인터페이스하는 MCP(Model Context Protocol) 서버로, LLM 클라이언트가 AniList의 애니메이션, 만화, 캐릭터, 스태프 및 사용자 데이터에 액세스하고 상호 작용할 수 있도록 합니다.

특징

• 애니메이션, 만화, 캐릭터, 스태프, 스튜디오 검색
• 특정 애니메이션, 만화, 캐릭터 및 스태프에 대한 자세한 정보를 얻으세요
• 사용자 프로필 및 목록에 액세스
• 고급 필터링 옵션 지원
• 장르 및 미디어 태그 검색

필수 조건

• 노드.js 18+

Claude Desktop(또는 다른 MCP 클라이언트)과 함께 사용

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 AniList MCP Server를 자동으로 설치하려면:

지엑스피1

mcp-get을 통해 설치

수동 설치

1. claude_desktop_config.json 에 이 서버를 추가하세요:

로그인이 필요한 작업에 AniList 토큰을 사용하지 않을 경우 env 객체를 완전히 제거할 수 있습니다.

2. Claude Desktop을 다시 시작하세요
3. 도구를 사용하여 AniList와 상호 작용하세요

환경 변수

• ANILIST_TOKEN : (선택 사항) AniList API 토큰(로그인이 필요한 작업에만 필요)

AniList API 토큰 받기(선택 사항)

API 토큰을 얻으려면 다음 단계를 따르세요.

1. AniList 설정 으로 이동합니다.
2. "신규 고객 만들기"를 클릭하세요.
3. 이 URL을 클라이언트의 "리디렉션 URL"로 사용하세요.

4. "저장"을 클릭하세요
5. 그런 다음 https://anilist.co/api/v2/oauth/authorize?client\_id={clientID}\&response\_type=token 으로 이동하여 {clientID} 발급받은 클라이언트 ID로 바꾸세요. 로그인을 요청한 후 사용할 토큰을 받게 됩니다.
6. 생성된 토큰을 복사하여 .env 파일이나 환경 변수에서 사용하세요.

사용 가능한 도구

기타 도구

• get_genres : AniList에서 사용 가능한 모든 장르를 가져옵니다.
• get_media_tags : AniList에서 사용 가능한 모든 미디어 태그를 가져옵니다.
• get_site_statistics : 지난 7일간의 AniList 사이트 통계를 가져옵니다.
• get_studio : AniList ID 또는 이름으로 스튜디오에 대한 정보를 가져옵니다.
• favorite_studio : [로그인 필요] ID로 스튜디오를 즐겨찾기에 추가하거나 즐겨찾기에서 제외합니다.

활동 도구

• delete_activity : [로그인 필요] 현재 권한이 있는 사용자의 활동 게시물을 삭제합니다.
• get_activity : ID로 특정 AniList 활동을 가져옵니다.
• get_user_activity : 사용자의 활동을 가져옵니다.
• post_message_activity : [로그인 필요] 새 메시지 활동을 게시하거나 기존 활동을 업데이트합니다.
• post_text_activity : [로그인 필요] 새로운 텍스트 활동을 게시하거나 기존 활동을 업데이트합니다.

목록 도구

• get_user_anime_list : 사용자의 애니메이션 목록을 가져옵니다.
• get_user_manga_list : 사용자의 만화 목록을 가져옵니다
• add_list_entry : [로그인 필요] 권한이 있는 사용자 목록에 항목을 추가합니다.
• remove_list_entry : [로그인 필요] 권한이 있는 사용자 목록에서 항목을 제거합니다.
• update_list_entry : [로그인 필요] 권한이 있는 사용자 목록에 있는 항목을 업데이트합니다.

미디어 도구

• get_anime : AniList ID로 애니메이션에 대한 자세한 정보를 가져옵니다.
• get_manga : AniList ID로 만화에 대한 자세한 정보를 가져옵니다.
• favorite_anime : [로그인 필요] ID로 애니메이션을 즐겨찾기 또는 즐겨찾기 해제합니다.
• favorite_manga : [로그인 필요] ID로 만화를 즐겨찾기 또는 즐겨찾기 해제합니다.

사람 도구

• get_character : AniList ID로 캐릭터에 대한 정보를 가져옵니다.
• get_staff : AniList ID로 직원 정보를 가져옵니다.
• favorite_character : [로그인 필요] ID로 캐릭터를 즐겨찾기에 추가하거나 즐겨찾기에서 제외합니다.
• favorite_staff : [로그인 필요] ID로 직원을 즐겨찾기에 추가하거나 즐겨찾기에서 제외합니다.
• get_todays_birthday_characters : 오늘이 생일인 모든 캐릭터를 가져옵니다.
• get_todays_birthday_staff : 오늘이 생일인 모든 직원을 가져옵니다.

추천 도구

• get_recommendation : ID로 AniList 추천을 가져옵니다.
• get_recommendations_for_media : 특정 미디어에 대한 AniList 추천을 받습니다.

검색 도구

• search_activity : AniList에서 활동 검색
• search_anime : 검색어와 필터를 사용하여 애니메이션 검색
• search_manga : 검색어와 필터를 이용해 만화 검색
• search_character : 쿼리 용어를 기반으로 문자를 검색합니다.
• search_staff : 쿼리 용어를 기반으로 직원을 검색합니다.
• search_studio : 검색어를 기준으로 스튜디오 검색
• search_user : AniList에서 사용자 검색

스레드 도구

• get_thread : AniList ID로 특정 스레드를 가져옵니다.
• get_thread_comments : 특정 스레드에 대한 댓글을 가져옵니다
• delete_thread : [로그인 필요] ID로 스레드 삭제

사용자 도구

• get_user_profile : 사용자의 AniList 프로필을 가져옵니다.
• get_user_stats : 사용자의 AniList 통계를 가져옵니다.
• get_full_user_info : 사용자의 전체 프로필 및 통계 정보를 가져옵니다.
• get_user_recent_activity : 사용자의 최근 활동을 가져옵니다.
• get_authorized_user : [로그인 필요] 현재 권한이 있는 사용자의 프로필 정보를 가져옵니다.
• follow_user : [로그인 필요] ID로 사용자를 팔로우하거나 팔로우 취소합니다.
• update_user : [로그인 필요] 사용자 설정 업데이트

사용 예

기본 애니메이션 검색

캐릭터 정보 얻기

스튜디오 작품 비교

지역 개발

이 프로젝트는 패키지 관리자로 Bun을 사용합니다. 아직 설치하지 않으셨다면 설치하세요.

저장소를 복제하고 종속성을 설치합니다.

구성(선택 사항)

1. 다음 예를 복사하여 .env 파일을 만듭니다.

2. .env 파일을 편집하고 AniList API 토큰을 추가하세요.

MCP Inspector를 사용한 디버깅

MCP Inspector를 사용하여 AniList MCP 서버를 테스트하고 디버깅할 수 있습니다.

그런 다음 제공된 URL(일반적으로 http://127.0.0.1:6274 )로 브라우저를 열어 MCP Inspector 인터페이스에 접속하세요. 여기에서 다음 작업을 수행할 수 있습니다.

1. 실행 중인 AniList MCP 서버에 연결하세요
2. 사용 가능한 도구 찾아보기
3. 사용자 정의 매개변수를 사용하여 도구 실행
4. 응답 보기

이 기능은 Claude나 다른 AI 보조 장치에 연결하기 전에 설정을 테스트하는 데 특히 유용합니다.

도커

Docker Hub에서 가져오기:

Docker 빌드(로컬 개발):

Docker 다중 플랫폼 빌드(로컬 개발):

보안 공지

이 MCP 서버는 .env 파일이나 환경 변수로 AniList API 토큰을 허용합니다. 이 정보는 안전하게 보관하고 버전 관리 시스템에 커밋하지 마십시오.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.