An MCP server that gives AI agents read-only access to a local research library (PDF, Markdown, BibTeX, RIS, ENW, XML).
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"local-research-library-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Local Research Library MCP [](https://pypi.org/project/local-research-library-mcp/) [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) > 让 AI Agent 安全地访问你的本地科研资料库。 A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that gives AI agents read-only access to your local research library. Search papers, fetch metadata, and find specific passages — all without leaving your machine. ## Features - **4 Tools**: `list_collections`, `search_papers`, `get_paper`, `search_in_paper` - **2 Resources**: `research://library` (overview), `research://papers/{paper_id}` (metadata) - **6 File Formats**: PDF, Markdown, BibTeX, RIS, EndNote, XML - **Auto-Index**: Detects new/changed files automatically (every 30s) - **Smart Scoring**: Title > Keywords > Abstract > Author > Body relevance ranking - **SQLite + FTS5**: Fast full-text search with graceful LIKE fallback - **Read-Only**: Never modifies your files - **Path-Safe**: Paper IDs validated, all reads stay inside library root ## Installation ### From PyPI ```bash pip install local-research-library-mcp ``` ### From Source ```bash git clone https://github.com/luhongyuan/local-research-library-mcp.git cd local-research-library-mcp pip install -e . ``` ## Quick Start ### 1. Configure MCP Client Add to your MCP client configuration (e.g., Cursor, Claude Desktop, Trae): ```json { "mcpServers": { "research-library": { "command": "local-research-library-mcp", "args": ["serve"], "env": { "RESEARCH_LIBRARY_ROOT": "/path/to/your/papers", "RESEARCH_LIBRARY_DB": "/path/to/your/papers/.index/library.db" } } } } ``` Or if installed from source: ```json { "mcpServers": { "research-library": { "command": "python", …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.