Endnote MCP

🚀 EndNote MCP

EndNote MCP可以將你的EndNote參考文獻庫連接到Claude AI。你可以直接在Claude桌面對話中搜索參考文獻、閱讀PDF、格式化引用、查找相關論文以及生成參考文獻列表。

🚀 快速開始

1. 安裝

# 使用uv（推薦）
uv tool install endnote-mcp

# 或者使用pip
pip install endnote-mcp

2. 從EndNote導出文獻庫

在EndNote中，選擇文件 → 導出，選擇XML格式，然後保存到一個方便的位置（例如桌面）。

3. 運行設置嚮導

endnote-mcp setup

嚮導將執行以下操作：

• 自動檢測你的XML導出文件和PDF目錄。
• 創建配置文件。
• 為你的文獻庫建立索引。
• 自動配置Claude桌面應用。

4. 重啟Claude桌面應用

關閉並重新打開Claude桌面應用，你會在MCP連接器中看到“EndNote Library”。

完成以上步驟後，就可以開始向Claude詢問關於參考文獻的問題了。

✨ 主要特性

• 強大的搜索功能：可以根據作者、標題、年份、關鍵詞、摘要等進行搜索，還支持語義搜索，能夠根據含義找到相關論文。
• 豐富的引用處理：支持多種引用格式（如APA 7th、Harvard、Vancouver、Chicago、IEEE），可以格式化單個引用，也能生成多個參考文獻的文獻列表。
• PDF閱讀：可以讀取PDF附件的特定頁面。
• 相關文獻查找：能夠找到與指定文獻相似的參考文獻。

📦 安裝指南

系統要求

• EndNote 20+（任何版本）
• Claude Desktop 應用程序
• Python 3.10+
• uv（推薦）或pip

安裝命令

# 使用uv（推薦）
uv tool install endnote-mcp

# 或者使用pip
pip install endnote-mcp

💻 使用示例

基礎用法

在Claude中，你可以提出以下類型的問題：

• "Search my library for social capital and Bourdieu"（在我的文獻庫中搜索關於社會資本和布迪厄的文獻）
• "Find papers about how organisations deal with uncertainty"（查找關於組織如何應對不確定性的論文）
• "Find references related to paper #3844"（查找與文獻 #3844 相關的參考文獻）
• "Give me the APA citation for reference #1234"（給出文獻 #1234 的APA引用格式）
• "Generate a bibliography for references 12, 45, 78, 102"（為文獻 12、45、78、102 生成文獻列表）
• "Export references 12, 45, 78 as BibTeX"（將文獻 12、45、78 導出為BibTeX格式）
• "Read pages 5 - 7 from that Smith et al. paper"（讀取Smith等人論文的第5 - 7頁）

高級用法

啟用語義搜索

# 安裝語義搜索依賴
pip install endnote-mcp[semantic]

# 生成嵌入向量（約3分鐘處理4000條參考文獻）
endnote-mcp embed

語義搜索可以根據含義查找參考文獻，即使文獻使用的術語與查詢不同。

📚 詳細文檔

命令說明

可供Claude使用的工具

添加新參考文獻

當你向EndNote文獻庫中添加新參考文獻時：

1. 從EndNote重新導出XML文件（覆蓋原文件）。
2. 可以選擇以下兩種方式之一：
   • 在終端中運行 endnote-mcp index。
   • 向Claude詢問："Rebuild my library index"。

索引是增量式的，只處理新的參考文獻和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                # 每次讀取請求的最大頁數

引用樣式

內置了五種引用樣式：

• 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詢問："Export references 42 and 100 as BibTeX"
• 或者直接使用 get_bibtex 工具，傳入用逗號分隔的記錄編號。

導出的條目包含完整的信息，包括正確的條目類型（@article、@book、@inproceedings 等）、引用鍵和所有可用字段。

🔧 技術細節

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) 進行連接。

📄 許可證

本項目採用AGPL - 3.0許可證，可免費使用、修改和分發。詳情請見 LICENSE。

🔍 故障排除

• "No configuration found" — 運行 endnote-mcp setup。
• "XML file not found" — 從EndNote重新導出：文件 → 導出 → XML格式。
• "PDF not found" — 檢查配置文件中的 pdf_dir 是否指向正確的 .Data/PDF 目錄。
• 搜索無結果 — 運行 endnote-mcp index 重建數據庫。
• Claude桌面應用未顯示工具 — 運行 endnote-mcp install，然後重啟Claude桌面應用。
• "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格式的引用。