{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_j3mdw6ghqp5x","handle":"local-research-library-mcp","url":"https://wellknown.network/agents/local-research-library-mcp","links":{"self":"https://wellknown.network/agents/local-research-library-mcp/record.json","html":"https://wellknown.network/agents/local-research-library-mcp","markdown":"https://wellknown.network/agents/local-research-library-mcp/record.md","api":"https://wellknown.network/api/v1/agents/local-research-library-mcp","status":"https://wellknown.network/api/v1/agents/local-research-library-mcp/status","claim":"https://wellknown.network/agents/local-research-library-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/local-research-library-mcp/claim.json","badge":"https://wellknown.network/agents/local-research-library-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/local-research-library-mcp/history","tools":"https://wellknown.network/api/v1/agents/local-research-library-mcp/tools"},"ard":{"identifier":"urn:air::server:local-research-library-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"local-research-library-mcp","summary":"An MCP server that gives AI agents read-only access to a local research library (PDF, Markdown, BibTeX, RIS, ENW, XML).","description":"# Local Research Library MCP\n\n[![PyPI version](https://img.shields.io/pypi/v/local-research-library-mcp)](https://pypi.org/project/local-research-library-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n\n> 让 AI Agent 安全地访问你的本地科研资料库。\n\nA [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.\n\n## Features\n\n- **4 Tools**: `list_collections`, `search_papers`, `get_paper`, `search_in_paper`\n- **2 Resources**: `research://library` (overview), `research://papers/{paper_id}` (metadata)\n- **6 File Formats**: PDF, Markdown, BibTeX, RIS, EndNote, XML\n- **Auto-Index**: Detects new/changed files automatically (every 30s)\n- **Smart Scoring**: Title > Keywords > Abstract > Author > Body relevance ranking\n- **SQLite + FTS5**: Fast full-text search with graceful LIKE fallback\n- **Read-Only**: Never modifies your files\n- **Path-Safe**: Paper IDs validated, all reads stay inside library root\n\n## Installation\n\n### From PyPI\n\n```bash\npip install local-research-library-mcp\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/luhongyuan/local-research-library-mcp.git\ncd local-research-library-mcp\npip install -e .\n```\n\n## Quick Start\n\n### 1. Configure MCP Client\n\nAdd to your MCP client configuration (e.g., Cursor, Claude Desktop, Trae):\n\n```json\n{\n  \"mcpServers\": {\n    \"research-library\": {\n      \"command\": \"local-research-library-mcp\",\n      \"args\": [\"serve\"],\n      \"env\": {\n        \"RESEARCH_LIBRARY_ROOT\": \"/path/to/your/papers\",\n        \"RESEARCH_LIBRARY_DB\": \"/path/to/your/papers/.index/library.db\"\n      }\n    }\n  }\n}\n```\n\nOr if installed from source:\n\n```json\n{\n  \"mcpServers\": {\n    \"research-library\": {\n      \"command\": \"python\",\n    …","publisher":{"name":"LHY","url":null},"homepage":"https://github.com/luhongyuan/local-research-library-mcp#readme","repository":"https://github.com/luhongyuan/local-research-library-mcp#readme","version":"0.2.0","license":"MIT","protocols":["mcp"],"tags":["mcp","research","papers","library","pdf","bibtex","academic","agent"],"pricing":null,"endpoints":[{"url":"pypi:local-research-library-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"research.academic","name":"Academic Research","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","research"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"local-research-library-mcp","registry":"pypi","observedAt":"2026-10-22T07:24:54.231Z","publishedAt":"2026-08-21T14:40:50.027562Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"local-research-library-mcp","url":"https://pypi.org/project/local-research-library-mcp/","firstSeenAt":"2026-09-09T23:25:59.792Z","fetchedAt":"2026-10-22T07:22:45.737Z","normalizedAt":"2026-10-22T07:22:45.737Z"}]},"firstSeenAt":"2026-09-09T23:25:59.792Z","updatedAt":"2026-10-22T07:24:54.231Z"}