Paperlib MCP

Paperlib MCP

学术文献管理和检索MCP服务器-支持PDF导入、混合搜索、知识图构建和文献综述生成。

 

中文 README

✨ 特性

📋 先决条件

• PostgreSQL 16+，带pgvector扩展
• MinIO或S3兼容存储
• OpenRouter API密钥

______________________________________________________________________

🚀 安装与使用

方法一：Docker Compose（推荐给初学者）

一键启动完整环境（PostgreSQL+MinIO+MCP）：

git clone https://github.com/h-lu/paperlib-mcp.git
cd paperlib-mcp

# Configure API Key
cp .env.example .env
# Edit .env and fill in OPENROUTER_API_KEY

# Start services
docker-compose up -d

在游标中配置

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "paperlib-docker": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "paperlib-mcp",
        "python",
        "-m",
        "paperlib_mcp.server"
      ]
    }
  }
}

方法2:uvx安装（推荐）

先决条件：需要可用的PostgreSQL（带pgvector）和MinIO/S3兼容的存储服务。

💡 Quick Start Local Services (Optional)

docker-compose up -d postgres minio minio-init

在Cursor/Claude Desktop中配置，根据您的实际服务地址修改环境变量：

{
  "mcpServers": {
    "paperlib": {
      "command": "uvx",
      "args": ["paperlib-mcp"],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_USER": "paper",
        "POSTGRES_PASSWORD": "paper",
        "POSTGRES_DB": "paperlib",
        "S3_ENDPOINT": "http://localhost:9000",
        "MINIO_ROOT_USER": "minio",
        "MINIO_ROOT_PASSWORD": "minio123",
        "OPENROUTER_API_KEY": "your-api-key"
      }
    }
  }
}

方法3：pip安装

先决条件：与方法2相同，需要可用的PostgreSQL和MinIO/S3服务。

pip install paperlib-mcp

配置MCP客户端（根据您的实际服务地址进行修改）：

{
  "mcpServers": {
    "paperlib": {
      "command": "paperlib-mcp",
      "args": [],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_USER": "paper",
        "POSTGRES_PASSWORD": "paper",
        "POSTGRES_DB": "paperlib",
        "S3_ENDPOINT": "http://localhost:9000",
        "MINIO_ROOT_USER": "minio",
        "MINIO_ROOT_PASSWORD": "minio123",
        "OPENROUTER_API_KEY": "your-api-key"
      }
    }
  }
}

方法4：地方发展

git clone https://github.com/your-org/paperlib-mcp.git
cd paperlib-mcp

uv sync
cp .env.example .env
# Edit .env

uv run python -m paperlib_mcp.server

______________________________________________________________________

📖 可用工具

基本工具

图形工具

书写工具

完整的工具列表（48+）可在 docs/MCP_TOOLS_REFERENCE.md

______________________________________________________________________

💡 使用示例

# Import PDF
> import_pdf file_path="/papers/study.pdf" title="Study Title"

# Search literature
> search_hybrid query="monetary policy" k=10

# Build knowledge graph
> extract_graph_v1 doc_id="abc123"
> build_communities_v1 level="macro"

# Generate review
> build_evidence_pack query="CBDC" k=40
> draft_lit_review_v1 pack_id=1

______________________________________________________________________

📚 文档

______________________________________________________________________

🛠️ 技术栈

______________________________________________________________________

环境变量

______________________________________________________________________

📄 许可证

麻省理工学院