中文

简介

你是否遇到过这些情况：

• AI 助手不知道你电脑上有哪些论文

• 记得看过某篇论文，但想不起文件名

• 想在一篇长论文里快速定位某个概念

Local Research Library MCP 就是为了解决这些问题而生的。它是一个本地 MCP 服务器，让 Cursor、Claude、Codex、Trae 等 AI Agent 能够直接浏览和搜索你电脑上的论文资料库。所有数据都留在本地，不会上传到任何地方。

工作原理

你的论文文件夹（PDF、BibTeX、Markdown ...）
        │
        ▼ 启动时自动扫描，每 30 秒检测新增文件
   ┌──────────┐
   │ 索引引擎  │  提取标题、作者、关键词、摘要、全文
   └────┬─────┘
        ▼
   ┌──────────┐
   │ SQLite   │  本地数据库 + 全文搜索
   └────┬─────┘
        ▼
   ┌──────────┐
   │ MCP 服务  │  通过 stdio 协议暴露给 AI 客户端
   └──────────┘

核心能力

支持格式

安全特性

• 🔒 只读：不会修改、删除或上传你的任何文件

• ️ 自动索引：启动时自动扫描，每 30 秒检测新增文件，放入新论文即可搜索

• 🔒 智能排序：标题 > 关键词 > 摘要 > 作者 > 正文，多维度加权

• ️ 路径安全：所有访问都限制在配置的论文文件夹内，防止越权读取

Related MCP server: directory-indexer

安装与配置

需要 Python 3.11+。以下两种方式任选其一，按步骤操作即可。

方式一：uvx（推荐）

无需手动安装，uvx 会自动下载并运行。

第 1 步：安装 uv（如没有）

pip install uv

第 2 步：添加 MCP 配置

在你的 MCP 客户端配置中加入：

GXP3

方式二：pip 安装

第 1 步：安装

pip install local-research-library-mcp

第 2 步：添加 MCP 配置

在你的 MCP 客户端配置中加入：

GXP5

⚠️ 路径说明

请务必将配置中的 <替换为...> 替换为你电脑上的实际路径！

RESEARCH_LIBRARY_DB 建议放在论文文件夹内的 .index 目录下。

使用

配置完成后，重启 AI 客户端，直接用自然语言问：

• "帮我找关于 graph neural network 的论文"

• "我有哪些论文分类？"

• "在这篇论文里搜一下 attention mechanism"

工具

搜索排序

命令行

local-research-library-mcp serve          # 启动服务器
local-research-library-mcp index          # 手动索引
local-research-library-mcp index --force  # 强制重新索引
local-research-library-mcp status         # 查看状态

环境变量

English

Introducción

¿Alguna vez te has encontrado con estos problemas?

• Tu asistente de IA no sabe qué artículos tienes en este equipo

• Recuerdas haber leído un artículo, pero no recuerdas el nombre del archivo

• Quieres localizar rále en seguida un concepto dentro de un artículo largo

Local Research Library MCP los resuelve resuelve todos. Es un servidor MCP local de lectura que permite a Cursor, Claude, Codex, Trae y otros agentes de IA navegar por tu biblioteca de investigación y buscar en enta directamente. Todos los datos permanecen en tu equipo — no se sube nada.

Cómo funciona

Your papers folder (PDF, BibTeX, Markdown, ...)
        │
        ▼ Scans on startup, checks for new files every 30s
   ┌──────────┐
   │ Indexer   │  Extracts title, authors, keywords, abstract, full text
   └────┬─────┘
        ▼
   ┌──────────┐
   │ SQLite    │  Local database + full-text search (FTS5)
   └────┬─────┘
        ▼
   ┌──────────┐
   │ MCP Server│  Exposes tools to AI clients via stdio protocol
   └──────────┘

Core Capabilities

Formatos compatiles

Seguridad

• 🔒 Solo lectura: Nunca modifica, elimini ni sube tus archivos

• ️ Indexación: Escane inicial, detecta archivos nuevos cada 30 seegundos

• 🔍️ Ranking inteligente: título > palabra clave > resumen > autor > cuerpo, puntuación multi-dimensional

• Rut segura: Todo el acceso a tu biblioteca se limita a la carpeta configurada

Instalación y configuación

Requiere Python 3.11 o superior. Selecciona una de las dos opciones siguientes y sigue los paso.

Opción C: uvx (recomensado)

No tienes que instar nada manualmente — uvx se instar? **uvx se descargará automáticamente.

Paso 1: Instalar uv (si aún no lo tienes)

pip install uv

Paso 2: Añade la configuación MCP

Añade lo siguiente a tu config...

{
  "mcpServers": {
    "research-library": {
      "command": "uvx",
      "args": ["local-research-library-mcp", "serve"],
      "env": {
        "RESEARCH_LIBRARY_ROOT": "<replace with your papers folder path>",
        "RESEARCH_LIBRARY_DB": "<replace with your index database path>"
      }
    }
  }
}

Opción B: pip

Paso 1: Instalación

pip install local-research-library-mcp

Paso 2: Añade la configuación MCP

Añade lo siguiente a tu config:

{
  "mcpServers": {
    "research-library": {
      "command": "local-research-library-mcp",
      "args": ["serve"],
      "env": {
        "RESEARCH_LIBRARY_ROOT": "<replace with your papers folder path>",
        "RESEARCH_LIBRARY_DB": "<replace with your index database path>"
      }
    }
  }
}

️ Instrucciónes de rutas

DEBES reemplazar los marcadores <reemplazar> con las rutas REAL del equipo.** | Con configuración ...

Uso

Después de la configuación, retinicia el cliente IA y pregunta:

• "Encontrá artículos sobre graf neura networks"

• "¿Qué colecciones tengo?"

• "Busca el «atención mechanism» in este art el artículo"

Herramientas

Rank de búsqueda

CLH

local-research-library-mcp serve          # Start server
local-research-library-mcp index          # Manual index
local-research-library-mcp index --force  # Force re-index
local-research-library-mcp status         # Show status

Variables de entorno

Licencia

MIT © Hongyuan Lu

Lectura...

Consulta CONTRIBUTING.md · Contatc: <hongyuanlu9@>