/ 디렉터리 / 플레이그라운드 / annas-mcp
← 모든 서버 ↗ GitHub
● 커뮤니티 iosifache ⚡ 바로 사용

annas-mcp

제작: iosifache · iosifache/annas-mcp

Search and download books and academic articles from Anna's Archive directly through your AI assistant.

annas-mcp provides an MCP server and CLI for searching and downloading documents from Anna's Archive. It supports book search by title/author/topic, article search by DOI or keyword, and direct downloads. Written in Go with pre-built binaries for all platforms. Requires an Anna's Archive API key obtained via donation.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

annas.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "annas": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "annas": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "annas": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "annas": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "annas",
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "annas": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/iosifache/annas-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add annas -- TODO 'See README: https://github.com/iosifache/annas-mcp'

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: annas-mcp

How to find and download a research paper with annas-mcp

👤 Researchers and students needing access to academic literature ⏱ ~5 min beginner

언제 쓸까: You need a specific paper by DOI or want to explore articles on a topic.

사전 조건
  • Anna's Archive API key — Donate at annas-archive.li to receive your API key
  • ANNAS_SECRET_KEY env var set — export ANNAS_SECRET_KEY=your_key
흐름
  1. Search for the article
    Search Anna's Archive for articles about 'transformer attention mechanisms' published after 2020.✓ 복사됨
    → List of matching articles with titles, authors, and DOIs
  2. Download the paper
    Download the first result to my papers folder.✓ 복사됨
    → File saved confirmation with path

결과: PDF of the requested paper saved locally.

함정
  • API key not set — Ensure ANNAS_SECRET_KEY is set in your environment before starting the MCP server
함께 쓰기: filesystem

Build a reading list on a topic using annas-mcp

👤 Anyone curating books or papers for study ⏱ ~10 min beginner

언제 쓸까: You want to compile a list of relevant books on a subject.

사전 조건
  • Anna's Archive API key — Donate at annas-archive.li
흐름
  1. Search for books
    Search for books about 'distributed systems' and list the top 10 results with authors and publication years.✓ 복사됨
    → Formatted list of books with metadata
  2. Download selected titles
    Download books 1, 3, and 7 from the list.✓ 복사됨
    → Three files saved with confirmation

결과: A curated set of downloaded books on the chosen topic.

함정
  • Download fails with certain mirrors — Set ANNAS_BASE_URL to a different mirror if the default is unreachable
함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

annas + filesystem

Download papers and organize them into topic-based folders automatically

Search for papers on 'reinforcement learning from human feedback', download the top 5, and organize them into ~/papers/rlhf/.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
book_search query: str Search for books by title, author, or topic 1 API call
book_download md5: str Download a book using its MD5 identifier from search results 1 API call
article_search query: str Find articles by DOI or keyword 1 API call
article_download doi: str Download an article by its DOI 1 API call

비용 및 제한

운영 비용

API 쿼터
Rate limits depend on your Anna's Archive API tier
호출당 토큰
200–500 tokens per search, more for downloads
금액
Requires donation to Anna's Archive for API access
팁
Use search first to identify exactly what you want before downloading to avoid unnecessary API calls.

보안

권한, 시크릿, 파급범위

자격 증명 저장: API key stored in ANNAS_SECRET_KEY environment variable
데이터 외부 송신: Calls to Anna's Archive API (configurable mirror URL)

문제 해결

자주 발생하는 오류와 해결

401 Unauthorized

Your ANNAS_SECRET_KEY is missing or invalid. Verify it's set correctly in your environment.

확인: echo $ANNAS_SECRET_KEY
Connection refused / timeout

The default mirror may be down. Set ANNAS_BASE_URL to an alternative mirror.

확인: curl https://annas-archive.li
No results found

Try broader search terms or different keywords. Book searches work best with exact titles or author names.

대안

annas-mcp 다른 것과 비교

대안언제 쓰나단점/장점
fetch MCPYou just need to grab a specific URL or DOI link directlyNo structured search — you need to know the exact URL

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기