Endnote MCP

🚀 EndNote MCP

EndNoteの参考文献ライブラリをClaude AIに接続します。参考文献の検索、PDFの閲覧、引用の書式設定、関連論文の検索、参考文献リストの生成などを、Claude Desktopの会話内で直接行うことができます。

🚀 クイックスタート

1. インストール

# uvを使う場合（推奨）
uv tool install endnote-mcp

# またはpipを使う場合
pip install endnote-mcp

2. EndNoteからライブラリをエクスポート

EndNoteで、「ファイル」→「エクスポート」を選択し、「XML」形式を選んで、便利な場所（例：デスクトップ）に保存します。

3. セットアップウィザードを実行

endnote-mcp setup

ウィザードは以下のことを行います。

• XMLエクスポートとPDFディレクトリを自動検出します。
• 設定を作成します。
• ライブラリをインデックス化します。
• Claude Desktopを自動的に設定します。

4. Claude Desktopを再起動

Claude Desktopを終了して再度開きます。MCPコネクタに「EndNote Library」が表示されます。

以上です。Claudeに参考文献に関する質問を始めましょう。

✨ 主な機能

セットアップ後、Claudeに以下のような質問をすることができます。

• "私のライブラリで社会的資本とブルデューの文献を検索して"
• "組織が不確実性に対処する方法に関する論文を探して"（意味検索）
• "文献#3844に関連する参考文献を見つけて"
• "文献#1234のAPA形式の引用を教えて"
• "文献12、45、78、102の参考文献リストを生成して"
• "文献12、45、78をBibTeX形式でエクスポートして"
• "そのスミスらの論文の5～7ページを読んで"

Claudeはローカルのライブラリを検索します。通常の会話以外では何もクラウドにアップロードされません。

📦 インストール

必要条件

• EndNote 20+（任意のエディション）
• Claude Desktopアプリ
• Python 3.10+
• uv（推奨）またはpip

💻 使用例

基本的な使用法

# インストール
uv tool install endnote-mcp

# セットアップウィザードの実行
endnote-mcp setup

高度な使用法

# 意味検索の依存関係をインストール
pip install endnote-mcp[semantic]

# 埋め込みを生成（4,000件の参考文献で約3分）
endnote-mcp embed

📚 ドキュメント

動作原理

EndNote Library → XML Export → endnote-mcp index → SQLite Database (FTS5 + Embeddings)
                                                          ↕
                                   Claude Desktop ← MCP Server (12 tools)

参考文献とPDFのテキストは、全文検索機能を持つローカルのSQLiteデータベースにインデックス化されます。オプションで、AI埋め込みを使用することで意味検索が可能になります。つまり、キーワードだけでなく意味に基づいて論文を検索できます。意味検索の依存関係がインストールされている場合、新しい参考文献はインデックス化時に自動的に埋め込まれます。ClaudeはModel Context Protocol (MCP)を通じて接続します。

コマンド

Claudeで利用可能なツール

新しい参考文献の追加

EndNoteライブラリに新しい参考文献を追加した場合：

1. EndNoteからXMLを再エクスポートします（同じファイルを上書き）。
2. 以下のいずれかを行います。
   • ターミナルからendnote-mcp indexを実行するか、
   • Claudeに*"私のライブラリインデックスを再構築して"*と依頼する。

インデックス化は増分です。つまり、新しい参考文献とPDFのみを処理し、ライブラリ全体を再度処理することはありません。意味検索がインストールされている場合、新しい参考文献は自動的に埋め込まれます。

パフォーマンス

設定

設定は以下の場所に保存されます。

• macOS: ~/Library/Application Support/endnote-mcp/config.yaml
• Windows: %APPDATA%/endnote-mcp/config.yaml
• Linux: ~/.config/endnote-mcp/config.yaml

endnote_xml: /path/to/your/library.xml
pdf_dir: /path/to/your/Library.Data/PDF
db_path: /path/to/library.db    # セットアップによって自動設定
max_pdf_pages: 30                # 読み取り要求ごとの最大ページ数

引用スタイル

5つの組み込みスタイルがあります。

• APA 7th — get_citation(rec_number=42, style="apa7")
• Harvard — style="harvard"
• Vancouver — style="vancouver"
• Chicago（著者 - 日付、第17版） — style="chicago"
• IEEE — style="ieee"

get_bibliographyを使用すると、複数の参考文献を一度に整形し、著者または年でソートすることができます。

BibTeXエクスポート

参考文献をLaTeXで使用するためのBibTeXエントリとしてエクスポートします。

• Claudeに*"文献42と100をBibTeX形式でエクスポートして"*と依頼するか、
• またはget_bibtexツールを直接使用して、カンマ区切りのレコード番号を指定します。

完全なエントリを生成し、適切なエントリタイプ（@article、@book、@inproceedingsなど）、引用キー、および利用可能なすべてのフィールドを含みます。

トラブルシューティング

• "No configuration found" — endnote-mcp setupを実行します。
• "XML file not found" — EndNoteから再エクスポートします：「ファイル」→「エクスポート」→「XML」形式。
• "PDF not found" — 設定のpdf_dirが正しい.Data/PDFディレクトリを指していることを確認します。
• 検索結果が返されない — endnote-mcp indexを実行してデータベースを再構築します。
• Claude Desktopにツールが表示されない — endnote-mcp installを実行してから、Claude Desktopを再起動します。
• "Semantic search is not available" — pip install endnote-mcp[semantic]を実行してからendnote-mcp embedを実行します。

このソフトウェアの引用

このツールを研究で使用した場合は、以下のように引用してください。

Gokmen, G. (2026). EndNote MCP: Connecting EndNote Reference Libraries to Claude AI (Version 1.4.5) [Computer software]. https://doi.org/10.5281/zenodo.18617546

または、GitHubの「Cite this repository」ボタンを使用して、BibTeX/APA形式で引用することもできます。

📄 ライセンス

AGPL - 3.0ライセンスです。自由に使用、変更、配布することができます。詳細はLICENSEを参照してください。