Zotero

🚀 Zotero MCP コネクタ

このコネクタは、ローカルの Zotero と Claude を統合するためのモデル制御プロトコル (MCP) コネクタです。Claude のデスクトップインターフェイスから直接、ローカルの Zotero ライブラリにアクセスできるようになります。このコネクタは、Zotero 7 のローカル Web API を利用しています。

このプロジェクトは、Node.js と Web API を使用した mcp - zotero リポジトリからインスピレーションを得ています。また、優れた pyzotero ライブラリに基づいて構築されています。

🚀 クイックスタート

このコネクタを使用することで、Claude のデスクトップインターフェイスから直接、ローカルの Zotero ライブラリにアクセスできます。以下に、インストールと設定の手順を説明します。

📦 インストール

Claude Desktop が MCP とどのように相互作用するかについては、こちら を参照してください。

1. uv を使用します。インストール手順は こちら を参照してください。

2. プロジェクトをローカルにクローンし、仮想環境をアクティブ化します。

git clone https://github.com/gyger/mcp-pyzotero.git
cd mcp-pyzotero
uv sync

3. Zotero 7 でローカル API を有効にします。

4. サーバーをローカルの Claude インストールに追加します。

uv run mcp install zotero.py

✨ 主な機能

コネクタは以下の機能を提供します。

• get_collections(): Zotero ライブラリ内のすべてのコレクションをリストアップします。
• get_collection_items(collection_key): 特定のコレクション内のすべてのアイテムを取得します。
• get_item_details(item_key): 特定の論文の詳細情報（要約を含む）を取得します。
• search_library(query): 全体の Zotero ライブラリを検索します。
• get_recent(limit = 10): ライブラリに最近追加された論文を取得します。

将来的には、これらの機能を拡張する予定です。

📚 ドキュメント

設定

コネクタはローカルの Zotero インストールと連携するように設定されており、現在は user ライブラリのみをサポートしています。デフォルトではユーザー ID 0 を使用しますが、環境変数 ZOTERO_USER_ID を設定することで指定することもできます。

uv run mcp install zotero.py -v ZOTERO_USER_ID=0

要件

• Python 3.10 以上
• ローカルの Zotero インストール
• Claude Desktop

コントリビューション

コントリビューションを歓迎します！GitHub リポジトリ を訪れて、以下のことができます。

• 問題を報告する
• プルリクエストを送信する
• 改善案を提案する

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。