docsagent/docsagent

解決する問題

DocsAgent MCP は、AIエージェント（Claude Desktop、Cursor、Clineなど）がユーザーのローカルなZotero研究ライブラリとやり取りできる方法を提供します。LLMに数千枚の学術PDFとノートへのアクセスを提供しつつ、厳格なローカルプライバシーと高速な検索を維持する問題を解決します。これにより、機密性の高い研究データをクラウドサービスにアップロードする必要がありません。

動作方法

このシステムは3層アーキテクチャを使用しています：

1. MCP Shell：TypeScriptまたはPythonで実装されたラッパー。Model Context Protocolを実装し、AIクライアントがツールを呼び出すための標準化されたインターフェースを提供します。
2. DocsAgent Core：バックグラウンドサービスとして実行されるC++検索エンジン。ローカルマシンから直接Zoteroデータベース（zotero.sqlite）とストレージファイルを読み取り、全文BM25インデックスを構築します。
3. Zotero Local API：シェルがライブラリに書き込み操作（ノートの追加やアイテムのインポートなど）を実行するために使用します。

対象ユーザー

Zoteroを使って文献を管理し、AIエージェントを使って論文を検索・要約・整理したい研究者、学術関係者、学生。

特徴

• 高性能：ネイティブC++コアを使用し、1,000枚以上のPDFを含むライブラリでも平均15msの検索遅延を実現。
• ローカル最優先のプライバシー：PDFやデータベースファイルはローカルマシンから一切外出しません。
• 包括的なツールセット：8つのMCPツールを提供。読み取り（検索、コンテンツ/メタデータ取得、ライブラリ一覧）と書き込み（アイテムのインポート、ノートの追加、一括タグ/コレクションの変更）に対応。
• 書き込みの安全性：3層のセーフティゲートにより、誤った変更を防ぎます。書き込み操作には明示的な設定と確認が必要です。
• 柔軟なデプロイ：stdioによるローカルクライアント対応と、RBACおよびOAuth 2.0対応のストリーミングHTTPによるリモートデプロイをサポート。