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格式的引用。