What it does
Find books, papers and dissertations with Anna's Archive and OpenAlex, then download or read them.
- Connects パソコンで動く
- Account or key No key needed
- Category ゲーム・スポーツ・料理・学習
この順位の理由
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 27/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 39/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: 78 (「急上昇」タブでのみ使用)
インストール
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
Anna's Archive and OpenAlex をインストールして。https://mcp.popnx.com/i/sokolskynikita-annas-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
AI にインストールしてもらう
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server Anna's Archive and OpenAlex を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "annas": { "command": "npx", "args": [ "-y", "annas-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Anna's Archive and OpenAlex のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "annas": { "command": "npx", "args": [ "-y", "annas-mcp" ] } } }Claude を終了してもう一度開く
試してみる
Anna's Archive and OpenAlex を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Anna's Archive and OpenAlex を使っていると言うか、回答に Anna's Archive and OpenAlex のツール名が出れば接続成功です
追加の設定 4 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ANNAS_SECRET_KEY書籍、アーカイブ検索、アーカイブのダウンロード用の任意の Anna's Archive シークレットキー。英語の原文を見る
Optional Anna's Archive secret key for books, archive searches and archive downloads.OPENALEX_API_KEY論文、学位論文、オープンアクセスの PDF、構造化された全文を取得するための、任意指定の OpenAlex API キーです。英語の原文を見る
Optional OpenAlex API key for papers, dissertations, open PDFs and structured full text.ANNAS_DOWNLOAD_PATHダウンロードしたファイルの保存先フォルダ。既定はホームフォルダ内の annas-archive です。英語の原文を見る
Folder for downloaded files. Defaults to annas-archive in your home folder.ANNAS_ACCOUNT_COOKIE署名済みブラウザから取得できる任意の aa_account_id2 Cookie。シークレットキーでのサインインが失敗した場合に使用します。英語の原文を見る
Optional aa_account_id2 cookie from a signed-in browser, for when signing in with the secret key fails.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Anna's Archive and OpenAlex につなげません
Anna's Archive and OpenAlex はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · Anna's Archive and OpenAlex につなげるアプリを使う
- 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- 先にパソコンへ Node.js を入れてください(1 回だけ)
- 先にパソコンへ Node.js を入れてください(1 回だけ)
- 先にパソコンへ Node.js を入れてください(1 回だけ)
B · ゲーム・スポーツ・料理・学習 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- ShipSwift✓ ChatGPT
- LearnHouse✓ ChatGPT
- Anime Garden✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server Anna's Archive and OpenAlex を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user annas -- npx -y annas-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Anna's Archive and OpenAlex のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user annas -- npx -y annas-mcpClaude Code で /mcp と入力
Anna's Archive and OpenAlex が一覧にあり、接続済みと表示されれば OK です
試してみる
Anna's Archive and OpenAlex を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Anna's Archive and OpenAlex を使っていると言うか、回答に Anna's Archive and OpenAlex のツール名が出れば接続成功です
追加の設定 4 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ANNAS_SECRET_KEY書籍、アーカイブ検索、アーカイブのダウンロード用の任意の Anna's Archive シークレットキー。英語の原文を見る
Optional Anna's Archive secret key for books, archive searches and archive downloads.OPENALEX_API_KEY論文、学位論文、オープンアクセスの PDF、構造化された全文を取得するための、任意指定の OpenAlex API キーです。英語の原文を見る
Optional OpenAlex API key for papers, dissertations, open PDFs and structured full text.ANNAS_DOWNLOAD_PATHダウンロードしたファイルの保存先フォルダ。既定はホームフォルダ内の annas-archive です。英語の原文を見る
Folder for downloaded files. Defaults to annas-archive in your home folder.ANNAS_ACCOUNT_COOKIE署名済みブラウザから取得できる任意の aa_account_id2 Cookie。シークレットキーでのサインインが失敗した場合に使用します。英語の原文を見る
Optional aa_account_id2 cookie from a signed-in browser, for when signing in with the secret key fails.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server Anna's Archive and OpenAlex を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "annas": { "command": "npx", "args": [ "-y", "annas-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Anna's Archive and OpenAlex のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
Cursor の AI チャットを Agent モードで開く
試してみる
Anna's Archive and OpenAlex を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Anna's Archive and OpenAlex を使っていると言うか、回答に Anna's Archive and OpenAlex のツール名が出れば接続成功です
追加の設定 4 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ANNAS_SECRET_KEY書籍、アーカイブ検索、アーカイブのダウンロード用の任意の Anna's Archive シークレットキー。英語の原文を見る
Optional Anna's Archive secret key for books, archive searches and archive downloads.OPENALEX_API_KEY論文、学位論文、オープンアクセスの PDF、構造化された全文を取得するための、任意指定の OpenAlex API キーです。英語の原文を見る
Optional OpenAlex API key for papers, dissertations, open PDFs and structured full text.ANNAS_DOWNLOAD_PATHダウンロードしたファイルの保存先フォルダ。既定はホームフォルダ内の annas-archive です。英語の原文を見る
Folder for downloaded files. Defaults to annas-archive in your home folder.ANNAS_ACCOUNT_COOKIE署名済みブラウザから取得できる任意の aa_account_id2 Cookie。シークレットキーでのサインインが失敗した場合に使用します。英語の原文を見る
Optional aa_account_id2 cookie from a signed-in browser, for when signing in with the secret key fails.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server Anna's Archive and OpenAlex を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "annas": { "type": "stdio", "command": "npx", "args": [ "-y", "annas-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Anna's Archive and OpenAlex のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
VS Code の AI チャットを Agent モードで開く
試してみる
Anna's Archive and OpenAlex を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Anna's Archive and OpenAlex を使っていると言うか、回答に Anna's Archive and OpenAlex のツール名が出れば接続成功です
追加の設定 4 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ANNAS_SECRET_KEY書籍、アーカイブ検索、アーカイブのダウンロード用の任意の Anna's Archive シークレットキー。英語の原文を見る
Optional Anna's Archive secret key for books, archive searches and archive downloads.OPENALEX_API_KEY論文、学位論文、オープンアクセスの PDF、構造化された全文を取得するための、任意指定の OpenAlex API キーです。英語の原文を見る
Optional OpenAlex API key for papers, dissertations, open PDFs and structured full text.ANNAS_DOWNLOAD_PATHダウンロードしたファイルの保存先フォルダ。既定はホームフォルダ内の annas-archive です。英語の原文を見る
Folder for downloaded files. Defaults to annas-archive in your home folder.ANNAS_ACCOUNT_COOKIE署名済みブラウザから取得できる任意の aa_account_id2 Cookie。シークレットキーでのサインインが失敗した場合に使用します。英語の原文を見る
Optional aa_account_id2 cookie from a signed-in browser, for when signing in with the secret key fails.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
開発者向け:ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user annas -- npx -y annas-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"annas": {
"command": "npx",
"args": [
"-y",
"annas-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"annas": {
"command": "npx",
"args": [
"-y",
"annas-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"annas": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"annas-mcp"
]
}
}
}自分で入力する値
ANNAS_SECRET_KEY秘密 env書籍、アーカイブ検索、アーカイブのダウンロード用の任意の Anna's Archive シークレットキー。英語の原文を見る
Optional Anna's Archive secret key for books, archive searches and archive downloads.OPENALEX_API_KEY秘密 env論文、学位論文、オープンアクセスの PDF、構造化された全文を取得するための、任意指定の OpenAlex API キーです。英語の原文を見る
Optional OpenAlex API key for papers, dissertations, open PDFs and structured full text.ANNAS_DOWNLOAD_PATHenvダウンロードしたファイルの保存先フォルダ。既定はホームフォルダ内の annas-archive です。英語の原文を見る
Folder for downloaded files. Defaults to annas-archive in your home folder.ANNAS_ACCOUNT_COOKIE秘密 env署名済みブラウザから取得できる任意の aa_account_id2 Cookie。シークレットキーでのサインインが失敗した場合に使用します。英語の原文を見る
Optional aa_account_id2 cookie from a signed-in browser, for when signing in with the secret key fails.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
- 週あたりのダウンロードi
- 1,077/週
- 接続方法
- パソコンで動く
- 最新バージョンi
- 0.8.2
- カテゴリi
- ゲーム・スポーツ・料理・学習
- レジストリ公開日i
- 2026年11月7日
- コードの最終更新i
- 2026年11月7日
- 作者
- SokolskyNikita
- パッケージ
npm: annas-mcp- ウェブサイト
- github.com
- レジストリでの状態
- 有効
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント SokolskyNikita で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:13 日前
- ✓ 合格
ライセンスがある
MITを使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
公開済みの脆弱性(OSV.dev)
OSV.dev に annas-mcp@0.8.2 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/sokolskynikita-annas-mcp)話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
ゲーム・スポーツ・料理・学習のほかのサーバーとの比較i
- このカテゴリのほかの1623件のうち96%よりスターが多い
- このカテゴリのほかの1623件のうち69%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの1623件のうち99%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Anna's Archive and OpenAlexは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は13 日前、最新バージョン(0.8.2)がレジストリに届いたのは13 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch
似た働きのほかの候補
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
WilmAI
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft
Savecraft serves real save game data and expert game knowledge to AI assistants.
GoodWatch
Find movies and TV shows, track watches, and get suggestions based on your taste.
| これ Anna's Archive and OpenAlex | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | GoodWatch | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | いいえ | いいえ | いいえ | はい | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 3/3 | 4/4 | 3/4 | 4/4 |
| ライセンス | MIT | AGPL-3.0 | MIT | MIT | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
annas-mcp
An MCP server and command-line tool for searching Anna's Archive and downloading books, papers, textbooks, manuals and standards. Use annas-cli in your terminal or connect annas-mcp to Claude, Cursor, Codex and other AI clients.
An Anna's Archive membership is required for archive access:
| Anna's Archive membership | Search through the MCP | Download by file hash or book-page URL |
|---|---|---|
| No paid membership | ❌ | ❌ |
| Brilliant Bookworm (cheapest tier) | ❌ | ✅ |
| Lucky Librarian or higher (recommended) | ✅ | ✅ |
Lucky Librarian or higher allows both search and download. With the basic tier, supply an archive file hash or book-page URL.
Disclaimer: I'm not affiliated with Anna's Archive. They were forced to introduce strict anti-scraping limits in 2026 due to massive DDoS attacks, with only paying members exempt.
[MCP setup](#mcp-setup) · [CLI setup](#cli-setup) · [Go SDK](https://github.com/SokolskyNikita/annas-mcp/blob/main/anna/README.md) · [Optional OpenAlex support](#openalex-optional)
The server signs in with your membership's secret key and renews the session by itself, so you never copy cookies from a browser. If you're coming from iosifache/annas-mcp, switching is a one-line change.
| Tool | What it does |
|---|---|
book_search | Finds books, textbooks, manuals and standards by title, author or topic, filtered by format, language, source or year; can include file activity counts |
article_search | Finds papers by title, author, topic, citation or DOI |
article_details | Inspects a selected paper's metadata and available copy details |
metadata_search | Searches library catalogs such as Open Library, WorldCat and ISBNdb for editions and ISBNs |
book_details | Shows a result's ISBNs and other identifiers, edition, description and reported file problems |
account_status | Shows your membership, search access and remaining fast downloads |
book_download | Downloads a book using a file hash or Anna's Archive book-page URL |
article_download | Downloads a paper by DOI or archive file hash |
article_read | Reads passages of structured full text with the optional OpenAlex integration |
Use it only for material you are entitled to obtain, under the laws and terms that apply to you.
Go SDK
Go applications can import github.com/SokolskyNikita/annas-mcp/anna for the same search, metadata, account and verified-download operations. See the SDK guide and examples for explicit configuration, errors, timeouts and concurrency. The SDK and applications share this module’s release tags. Requires Go 1.26 or newer; install with go get github.com/SokolskyNikita/annas-mcp/anna@v0.8.0.
Setup
You need Node.js 18 or newer and your Anna's Archive secret key. Search needs Lucky Librarian or higher; download works with any paid tier.
Anna’s Archive key
Copy the secret key you log in with from your Anna's Archive account page. It is also your API key (API FAQ).
MCP setup
Add the server to your client with ANNAS_SECRET_KEY set to your membership's secret key.
Claude Code
claude mcp add annas-mcp \
--env ANNAS_SECRET_KEY=your-secret-key \ -- npx -y annas-mcp
On native Windows (not WSL), end the command with -- cmd /c npx -y annas-mcp.
Claude Desktop, one click
Download annas-mcp.mcpb and open it, or drag it onto Settings → Extensions. Enter your Anna's Archive key and choose a download folder. You can skip the other optional settings.
Claude Desktop or Cursor, by hand
Add this to Claude Desktop's config (Settings → Developer → Edit Config) or to Cursor's ~/.cursor/mcp.json:
{
"mcpServers": { "annas-mcp": { "command": "npx", "args": ["-y", "annas-mcp"], "env": { "ANNAS_SECRET_KEY": "your-secret-key" } } } }
Codex
Add this to ~/.codex/config.toml:
[mcp_servers.annas-mcp]
command = "npx" args = ["-y", "annas-mcp"]
[mcp_servers.annas-mcp.env] ANNAS_SECRET_KEY = "your-secret-key"
Homebrew: lighter on memory
npx keeps npm running beside the server for the whole session, about 100 MB per client window. On macOS and Linux, Homebrew installs the binary itself, so each client starts only the server, about 20 MB:
brew install SokolskyNikita/tap/annas-mcp
Then use annas-mcp as the command in any of the configurations above, with mcp as its only argument ("args": ["mcp"] in JSON, args = ["mcp"] in TOML). For Claude Code:
claude mcp add annas-mcp \
--env ANNAS_SECRET_KEY=your-secret-key \ -- annas-mcp mcp
The same install provides annas-cli. Update with brew upgrade annas-mcp; unlike npx, the server does not check for new releases itself.
Gemini CLI
gemini extensions install https://github.com/SokolskyNikita/annas-mcp
Enter your Anna's Archive key, which Gemini CLI keeps in the system keychain, and choose a download folder. Skip the other optional settings unless you need them. Change them later with gemini extensions config annas-mcp.
Docker
Build the image straight from this repository:
docker build -t annas-mcp https://github.com/SokolskyNikita/annas-mcp.git
Then have your client run it, mounting your download folder at /downloads:
{
"mcpServers": { "annas-mcp": { "command": "docker", "args": ["run", "-i", "--rm", "-e", "ANNAS_SECRET_KEY", "-v", "/absolute/path/to/downloads:/downloads", "annas-mcp"], "env": { "ANNAS_SECRET_KEY": "your-secret-key" } } } }
On Linux, add "--user", "1000:1000" with your own user and group IDs before "annas-mcp", so the container can write to the folder.
Try it
Restart your client and ask *"Find the EPUB of Pride and Prejudice and download it"* or *"Download the paper with DOI 10.1038/nature14539."* The AI locates the copy and tells you where it saved the file: annas-archive in your home folder unless you chose another.
CLI setup
Install both commands with one package:
npm install -g annas-mcp
export ANNAS_SECRET_KEY="your-secret-key"
annas-cli --help annas-cli book-search "pride and prejudice" --language en --format epub
Both commands support the same operations. With no arguments, annas-cli shows help and annas-mcp starts MCP. See Configuration for settings and Command line for all commands.
Or run without installing globally:
npx -y --package=annas-mcp annas-cli book-search "pride and prejudice" --format epub
Switching from iosifache/annas-mcp
This server retains the original four tools, adds research and catalog tools, and reads the same ANNAS_SECRET_KEY, ANNAS_DOWNLOAD_PATH and ANNAS_BASE_URL variables. In your client's config, replace the path to the old binary with npx:
- "command": "/path/to/annas-mcp",
- "args": ["mcp"],
- "command": "npx",
- "args": ["-y", "annas-mcp"],
What changes:
- Searches run as your signed-in member account, so they aren't turned away with
403by the archive's browser check. Searching needs Lucky Librarian or higher. - The server picks a working official mirror by itself. Set
ANNAS_AUTO_BASE_URL=falseto use onlyANNAS_BASE_URL. - Downloads are checked against the archive's MD5 hash.
npxpicks up new releases without a manual download.
Signing in
Anna's Archive only lets signed-in members search. The server signs in with your secret key before its first request and again whenever the archive ends the session, about once a week. The session is saved between runs.
If signing in fails, the error says what each mirror answered and how to give the server a browser session instead:
- Sign in to Anna's Archive in your browser, open its developer tools and go to Application (Chrome, Edge) or Storage (Firefox, Safari) → Cookies.
- Copy the value of
aa_account_id2intoANNAS_ACCOUNT_COOKIEand restart the MCP server from your client.
The server uses that cookie until it expires, then signs in with the secret key again. Keep the secret key and cookie private.
Configuration
| Variable | Needed for | Description |
|---|---|---|
ANNAS_SECRET_KEY | Archive operations | Your Anna's Archive secret key. The server signs in with it and uses it for downloads. |
ANNAS_DOWNLOAD_PATH | Optional | Folder for downloaded files. Defaults to annas-archive in your home folder. See Choosing the download folder. |
ANNAS_ACCOUNT_COOKIE | Optional | An aa_account_id2 cookie to use before signing in. See Signing in. |
ANNAS_BASE_URL | Optional | Mirror to try first; the official mirrors stand in for it while it fails. Defaults to annas-archive.gl. Language versions such as es.annas-archive.gl are refused, since the server reads the archive in English. |
ANNAS_AUTO_BASE_URL | Optional | Set to false to always use ANNAS_BASE_URL instead of picking a mirror automatically. |
ANNAS_MCP_CACHE_DIR | Optional | Where the server saves provider sessions and research cache metadata, and npx caches release binaries. See The cache folder. |
OPENALEX_API_KEY | Optional | Enables OpenAlex support for additional paper and dissertation access. |
The server and CLI also read a .env file from their working directory. Variables already set in the environment take precedence. Terminal commands can inherit an exported key from your shell. Desktop MCP clients usually need the key in their own environment configuration. The program reads environment variables; it does not source .zshrc or .zshrc.secrets. Keep keys out of chat, tool arguments and repository files.
The server only uses ANNAS_BASE_URL and the official mirrors annas-archive.gl, .pk and .gd; Choosing a mirror explains how it picks one. Whatever host you set in ANNAS_BASE_URL receives your credentials, so only use one you trust.
Choosing the download folder
Downloads go to ~/annas-archive (%USERPROFILE%\annas-archive on Windows), which is created on the first download. Set ANNAS_DOWNLOAD_PATH to use another folder. It must be an absolute path, except that a leading ~ stands for your home folder.
On macOS, Desktop, Documents, Downloads and iCloud Drive are protected: the first download there makes macOS ask whether your MCP client may access the folder. If that access is denied, downloads fail with [CONFIG] cannot write to the download folder; allow your client in System Settings → Privacy & Security → Files and Folders, or pick a folder directly in your home folder. Avoid /tmp, which the operating system clears.
Tools
The AI fills in each tool's options from your request. HOW-IT-WORKS.md lists them and what each tool returns, and --help shows them on the [command line](#command-line