Zotero MCP

by 54yyyu
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Connects to your Zotero research library, allowing you to search for papers, articles and books, retrieve metadata, access full-text content, and browse collections, tags, and recent additions.

Zotero MCP: クロードにあるあなたの研究図書館

Zotero MCPは、モデルコンテキストプロトコルを介して、 ZoteroリサーチライブラリをClaudeやその他のAIアシスタントとシームレスに接続します。論文の議論、要約の取得、引用の分析など、様々な機能をご利用いただけます。

🚀 クイックインストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Zotero MCP を自動的にインストールするには:

npx -y @smithery/cli install @54yyyu/zotero-mcp --client claude

pip経由でインストール

pip install git+https://github.com/54yyyu/zotero-mcp.git zotero-mcp setup # Auto-configure for Claude Desktop

✨ 特徴

ライブラリを検索

  • 論文、記事、書籍をタイトル、著者、内容で検索
  • 複数の条件で複雑な検索を実行する
  • コレクション、タグ、最近追加されたものを閲覧する

コンテンツにアクセスする

  • 任意のアイテムの詳細なメタデータを取得する
  • 全文コンテンツを取得する(利用可能な場合)
  • 添付ファイル、メモ、子アイテムにアクセスする

🖥️ セットアップと使用方法

クロードデスクトップ向け

インストール後、次のいずれかを実行します。

  1. 自動構成(推奨):
    zotero-mcp setup
  2. 手動設定: claude_desktop_config.jsonに追加します:
    { "mcpServers": { "zotero": { "command": "zotero-mcp", "env": { "ZOTERO_LOCAL": "true" } } } }

要件

  • Python 3.10以上
  • Zotero 7+(フルテキストアクセス可能なローカルAPI用)
  • Claudeデスクトップまたは互換性のあるAIアシスタント

ClaudeでZoteroを使用する

  1. Zoteroデスクトップを起動します(設定でローカルAPIが有効になっていることを確認してください)
  2. Claudeデスクトップを起動
  3. Claude DesktopのツールインターフェースからZotero-MCPツールにアクセスします。

プロンプトの例:

  • 「機械学習に関する論文を私のライブラリで検索する」
  • 「気候変動について最近追加した記事を見つける」
  • 「量子コンピューティングに関する私の論文の主要な調査結果を要約してください」

🔧 詳細設定

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

Web API 経由で Zotero ライブラリにアクセスするには (リモート設定に便利です):

zotero-mcp setup --no-local --api-key YOUR_API_KEY --library-id YOUR_LIBRARY_ID

環境変数

  • ZOTERO_LOCAL=true : ローカルの Zotero API を使用する (デフォルト: false)
  • ZOTERO_API_KEY : Zotero API キー (Web API 用)
  • ZOTERO_LIBRARY_ID : Zotero ライブラリ ID (Web API 用)
  • ZOTERO_LIBRARY_TYPE : ライブラリの種類(ユーザーまたはグループ、デフォルト: ユーザー)

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

# Run the server directly zotero-mcp serve # Specify transport method zotero-mcp serve --transport stdio|sse # Get help on setup options zotero-mcp setup --help

📚 利用可能なツール

検索ツール

  • zotero_search_items : ライブラリを検索
  • zotero_advanced_search : 複雑な検索を実行する
  • zotero_get_collections : コレクションの一覧を取得する
  • zotero_get_collection_items : コレクション内のアイテムを取得する
  • zotero_get_tags : すべてのタグを一覧表示する
  • zotero_get_recent : 最近追加されたアイテムを取得する

コンテンツツール

  • zotero_get_item_metadata : 詳細なメタデータを取得する
  • zotero_get_item_fulltext : 全文コンテンツを取得する
  • zotero_get_item_children : 添付ファイルとメモを取得する

🔍 トラブルシューティング

  • 結果が見つかりません: Zotero が実行中で、ローカル API が有効になっていることを確認してください
  • ライブラリに接続できません: Web API を使用している場合は、API キーとライブラリ ID を確認してください
  • 全文は利用できません: ローカルの全文アクセスには Zotero 7 以降を使用していることを確認してください

📄 ライセンス

マサチューセッツ工科大学

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

モデル コンテキスト プロトコルを介して Zotero リサーチ ライブラリを Claude やその他の AI アシスタントに接続し、ライブラリの検索、コンテンツへのアクセス、論文の議論、要約の取得、引用の分析が可能になります。

  1. 🚀 Quick Install
    1. Installing via Smithery
    2. Installing via pip
  2. ✨ Features
    1. Search Your Library
    2. Access Your Content
  3. 🖥️ Setup & Usage
    1. For Claude Desktop
    2. Requirements
    3. Using Zotero in Claude
  4. 🔧 Advanced Configuration
    1. Using Web API Instead of Local API
    2. Environment Variables
    3. Command-Line Options
  5. 📚 Available Tools
    1. Search Tools
    2. Content Tools
  6. 🔍 Troubleshooting
    1. 📄 License
      ID: yfe03znm4t