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