Skip to main content
Glama
yang-kun-long

Library Access MCP

Library Access MCP

让 AI 直接访问需要认证的学术数据库。

浏览器插件 + MCP 服务器,AI 助手通过已登录的浏览器 Session 搜索论文、抓取元数据,无需重新登录、无需暴露密码。

解决的问题

  • 反复认证:VPN 断了、Session 过期、跨库跳转——全部自动处理

  • 手动搬运:摘要、作者、DOI、影响因子、基金项目——一键抓取

  • AI 爬虫被拦:直接复用浏览器已有的学术权限,绕过反爬

Related MCP server: browser-relay-mcp

核心特性

  • 复用浏览器 Session:不传账号密码,AI 借用你已登录的权限

  • 自动登录兜底:Session 过期时自动重新认证,对 AI 透明

  • 元数据深度抓取:单位、基金、核心收录(核/源)、影响因子、标准引文格式

  • 资产固化:论文自动转为结构化 Markdown,实时同步研究索引

  • 本地运行:全程 localhost,不上传任何数据

工作原理

Claude Code ──HTTP──> MCP Server (localhost:8766)
                           │
                        WebSocket (localhost:8765)
                           │
                      浏览器插件 ──> 学术数据库(带认证)

安装

下载

从 Releases 下载最新的 library-access-mcp-vX.X.X.zip,解压后包含:

library-access-mcp/
├── extension/          # Chrome 插件目录
└── mcp-server.exe      # Windows 服务端(托盘运行)

安装插件

  1. 打开 chrome://extensions/

  2. 开启右上角开发者模式

  3. 点击加载已解压的扩展程序,选择解压后的 extension/ 目录

启动服务端

Windows(推荐):双击 mcp-server.exe,系统托盘出现图标即表示运行中。

源码运行:

cd mcp-server
pip install -r requirements.txt
python server.py

服务端启动后监听:

  • http://localhost:8766/mcp — MCP 端点(供 Claude Code 连接)

  • ws://localhost:8765 — WebSocket 端点(供插件连接)

注册到 Claude Code

claude mcp add --transport http \
  -H "Authorization: Bearer library-access-for-LiuWen" \
  --scope user \
  -- library-access http://localhost:8766/mcp

或手动在 ~/.claude.json 的 mcpServers 中添加:

"library-access": {
  "type": "http",
  "url": "http://localhost:8766/mcp",
  "headers": {
    "Authorization": "Bearer library-access-for-LiuWen"
  }
}

注册到 OpenCode

在 OpenCode 配置文件 ~/.config/opencode/opencode.json 的 mcp 字段中添加:

{
  "mcp": {
    "library-access": {
      "type": "remote",
      "url": "http://localhost:8766/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer library-access-for-LiuWen"
      }
    }
  }
}

注意:OpenCode 使用 "type": "remote" 而不是 "type": "http"。

使用

连接成功后,在 Claude Code 中直接对话即可:

"帮我搜索近三年关于大模型的综述论文" "获取第一篇的详情并保存"

AI 会自动处理登录、搜索、抓取、保存全流程。

可用工具

工具

说明

ping_test

测试插件连接状态

login_library

登录图书馆(支持多校,自动兜底同步发现系统 Session)

search_papers

搜索论文(自动检测登录状态)

get_paper_detail

抓取论文完整元数据

download_paper

下载论文 PDF

persist_paper

将论文固化为本地 Markdown 笔记

支持的学校

学校

代码

认证方式

是否需要凭证

北京理工大学

BIT

CAS + Session 同步

否(复用浏览器 session)

北京航空航天大学

BUAA

CARSI/Shibboleth

是(username + password)

其他学校

MANUAL

手动登录

—

使用示例

# BIT(默认,无需凭证)
> "登录图书馆"

# BUAA(需要凭证)
> "用北航账号登录图书馆,用户名 xxx,密码 xxx"

添加新学校

新增学校只需:

  1. 在 extension/providers/ 下创建 xxx-provider.js,继承 LoginProvider

  2. 在 extension/background.js 中注册 Provider

无需修改服务端代码。详见 多校支持开发指南。

排错

插件连接不上:

curl http://localhost:8766/health
# {"status":"ok","plugins":1}   plugins=1 表示插件已连接

校外访问失败:调用 login_library 工具,会自动完成 CAS 认证和发现系统 Session 同步。

开发状态

当前版本:v0.2.5

  • WebSocket 通信与心跳保活

  • 智真发现系统深度元数据抓取

  • 校外自动登录兜底(SSO 重定向构造)

  • 搜索前自动检测登录状态

  • Windows 托盘二进制打包

  • 多校 Provider 架构(BIT + BUAA 验证通过)

  • IEEE Xplore 支持

  • 更多高校 Provider

文档

许可

MIT License

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    Enables AI assistants to access content from authenticated web pages by opening a real browser for manual login and session capture. It saves browser profiles locally so users only need to log in once per service for future automated access.
    4
    50 npm
    36
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables AI agents to access authenticated websites by reusing your existing browser profile and cookies, so you never share passwords and sessions persist between runs.
    5
    5
    MIT