Zotero MCP

🚀 Zotero MCP：あなたの研究資料室Claude

Zotero MCPは、ZoteroとClaudeなどの人工知能アシスタントを接続するツールです。MCPプロトコルを通じて、研究資料のアクセスと管理を行うことができます。

🚀 クイックスタート

Zotero MCPを使うことで、Zoteroの研究資料をClaudeなどのAIアシスタントと連携し、効率的に管理することができます。

✨ 主な機能

検索機能

• 資料室検索：文献リソースを迅速に探すことができます。
• 高度な検索：複雑なクエリ条件をサポートし、必要な内容を正確に見つけるのに役立ちます。
• お気に入り管理：すべてのお気に入りとそれに含まれる文献を一覧表示して確認できます。
• 最近の更新：資料室に最近追加された文献を取得できます。

コンテンツアクセス

• メタデータ検索：文献のタイトル、著者、出版年などの詳細情報を取得できます。
• 全文取得：サポートされている場合、文献の全文内容を直接閲覧できます。
• 添付ファイル管理：文献に関連付けられたすべての添付ファイルとメモを確認できます。

注釈とメモの処理

• 注釈抽出：PDFファイルから手書きまたはテキストの注釈を直接抽出できます。
• メモ検索：Zoteroに追加したすべてのメモにすばやくアクセスできます。
• 内容検索：メモと注釈、PDFから抽出した内容を含め、全文検索が可能です。
• 新規メモ作成：特定の文献に新しい注釈を作成できます（テスト機能）。

柔軟な接続方法

• ローカルAPIの使用：Zoteroのローカルサービスを通じて資料室にアクセスできます。
• Web APIの接続：リモートサーバー上の資料室にアクセスすることができますが、対応するAPIキーと資料室IDが必要です。

📦 インストール

Smitheryを使用したインストール

# 直接インストールしてサービスを起動
zotero-mcp setup

手動インストール（uv方式）

1. ソースコードのダウンロード：プロジェクトリポジトリからクローンまたはダウンロードします。
2. インストールスクリプトの実行：

   uv zotero-mcp run
   

3. サービスの起動：

   zotero-mcp serve
   

pipを使用したインストール

pip install zotero-mcp

🔧 高度な設定

ローカルAPIの代わりにWeb APIを使用する

zotero-mcp setup --no-local --api-key あなたのAPIキー --library-id あなたの資料室ID

環境変数

• ZOTERO_LOCAL=true：ローカルのZoteroサービスを使用します（デフォルトはfalse）。
• ZOTERO_API_KEY：あなたのZotero Web APIキー。
• ZOTERO_LIBRARY_ID：アクセスする資料室のID。
• ZOTERO_LIBRARY_TYPE：資料室のタイプで、userまたはgroupを選択できます（デフォルトはuser）。

コマンドラインオプション

# サービスを直接実行
zotero-mcp serve

# 転送方式を指定
zotero-mcp serve --transport stdio|sse

# 詳細な設定のヘルプを取得
zotero-mcp setup --help

💻 使用例

基本的な使用法

# Smitheryを使用したインストール
zotero-mcp setup

高度な使用法

# Web APIを使用した設定
zotero-mcp setup --no-local --api-key あなたのAPIキー --library-id あなたの資料室ID

📚 ドキュメント

PDF注釈抽出機能

Zotero MCPは強力なPDF注釈処理機能を提供します。

• 直接PDF解析：Zoteroのインデックス機能に依存せず、PDF内の手書きおよびテキスト注釈を抽出できます。
• 強化検索：注釈内容を全文検索できます。
• 画像注釈サポート：PDF内の画像注釈を識別して抽出できます。
• シームレスな統合：Zoteroのネイティブ注釈システムと完全に互換性があります。

💡 使用アドバイス

最適な体験を得るために、Zotero Better BibTeXプラグインのインストールをおすすめします。この機能は、プラグイン環境でより良い性能を発揮します。

利用可能なツールセット

検索系ツール

• zotero_search_items：資料室の文献を検索します。
• zotero_advanced_search：高度な複雑なクエリを実行します。
• zotero_get_collections：すべてのお気に入りリストを取得します。
• zotero_get_collection_items：特定のお気に入り内の文献を表示します。
• zotero_get_tags：すべてのタグを一覧表示します。
• zotero_get_recent：最近追加された文献を取得します。

コンテンツアクセスツール

• zotero_get_metadata：文献の詳細なメタデータを取得します。
• zotero_get_fulltext：サポートされている場合、文献の全文内容を取得します。
• zotero_list_attachments：文献に関連する添付ファイルのリストを表示します。

注釈処理ツール

• zotero_extract_annotations：PDFから注釈内容を抽出します。
• zotero_search_notes：すべてのメモと注釈を全文検索します。
• zotero_create_note：特定の文献に新しい注釈を作成します。

トラブルシューティングとサポート

問題が発生した場合は、プロジェクトの公式サイトにアクセスするか、ユーザーコミュニティに参加して支援を求めてください。

• プロジェクトホームページ：https://github.com/yourusername/zotero-mcp
• ユーザーフォーラム：https://discussions.zotero.org

📄 ライセンス

このプロジェクトはMITオープンソースライセンスに従います。詳細な条項は、プロジェクトのLICENSEファイルを参照してください。