Claude Research Bibliography MCP Server Suite

使用说明(Markdown 格式)

项目概览

  • 这是一个包含两个 MCP 服务器实现的完整套件,面向学术研究场景的上下文与工具服务。服务器通过标准的 MCP 接口暴露资源、工具与提示模板,LLM 客户端可通过 JSON-RPC 请求读取资源、调用工具、获取并渲染 Prompt。

主要功能点

  • MCP 服务器核心:实现 MSP(Model Context Protocol)风格的请求处理、响应与通知,支持资源、工具、Prompts 的托管与渲染。
  • 资源与数据源整合:内置 OpenAlex、Scopus、Web of Science 等数据源的适配器,具备跨源查询、去重与结果格式化能力。
  • 工具与格式化:定义多种学术查询工具(如论文检索、作者分析、趋势分析、DOI验证等),以及将查询结果格式化成 Markdown 表格/详细页的格式化函数。
  • 会话与诊断:提供跨会话的上下文记忆、源诊断与状态汇总,便于 LLM 在不同会话之间保持上下文一致性。
  • 传输协议与入口:当前实现通过标准的 stdio 传输与 MCP 服务端入口启动,便于在本地开发环境或嵌入式部署中对接 LLM 客户端。

安装与运行

  • 获取源码:将仓库克隆到本地。
  • 运行方式:仓库内存在两个 MCP 服务器实现,分别对应不同的服务域: -/.mcp-server-bibliography/server.py 负责多源学术检索(OpenAlex + Scopus + WoS)。 -/.mcp-server-biblio/server.py 另一份多源学术检索实现,结构与功能类似。
  • 启动命令示例(在项目根目录下执行):
    • 启动 Bibliography MCP 服务器: python3 .mcp-server-bibliography/server.py
    • 启动 Bibliography-Biblio MCP 服务器: python3 .mcp-server-biblio/server.py
  • 依赖与环境变量:部分源需要 API Key(如 SCOPUS_API_KEY、WOS_API_KEY),OpenAlex 使用 polite pool 通过内置 OpenAlex 客户端访问。请根据需要设置相应的环境变量(例如 SCOPUS_API_KEY、WOS_API_KEY、WOS_API_TIER 等)以启用对应源。

与 MCP 客户端对接的配置(示例) 说明:以下 JSON 配置用于 MCP 客户端启动时指定要连接的 MCP 服务器。一个配置结构示例可同时包含多台服务器以支持多套服务。请将路径替换为实际使用的可执行脚本路径。 { "servers": [ { "server_name": "bibliography", "command": "python3", "args": [ "./.mcp-server-bibliography/server.py" ], "description": "MCP 服务器:多源学术检索(OpenAlex + Scopus + WoS),输出工具和资源并通过 MCP 进行 JSON-RPC 通信。" }, { "server_name": "bibliography-biblio", "command": "python3", "args": [ "./.mcp-server-biblio/server.py" ], "description": "MCP 服务器实现变体,提供跨源学术检索能力与上下文服务。" } ] } 说明:

  • server_name:服务器对外标识名,用于区分不同的 MCP 服务实例(如同一项目中的两个实现)。
  • command 与 args:启动服务器的执行命令和参数;本实现采用 Python 脚本直接运行入口。
  • description:简短描述,便于客户端在配置阶段了解服务用途。
  • 传输方式:当前实现使用标准输入输出(stdio)作为 MCP 传输载体,客户端应通过启动服务器进程并建立对等的 JSON-RPC 通道来进行通信。

基本使用方法

  • 在本地开发环境中启动任一 MCP 服务器后,客户端应通过 JSON-RPC 调用读取资源、执行工具、获取 Prompt 等能力。
  • 服务端对外的能力包括:资源/工具/Prompts 的注册、查询与执行,以及对多源数据的聚合、去重与格式化。
  • 如需扩展,请参考各子目录下的实现(sources、scripts、tools、hooks、mcp-server-*),确保遵循 MCP 的请求/响应格式进行扩展。

关键词 OpenAlex, 多源检索, 学术资源, JSON-RPC, 上下文服务

分类ID 6

服务器信息