Z3950 MCP

MCP搜索检索

提供方 codefzer

搜索检索 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个快速、高效的MCP服务器,用于搜索多个支持Z39.50的图书馆系统的目录。

一句话选型结论

按资料字段整理

Z3950 MCP 属于搜索检索类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 6 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量6暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

图书馆目录Python本地部署Z39.50协议并行搜索MARC记录书目检索

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 6 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Z3950 MCP当前 6 stdio · 本地进程 本地部署 有 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方codefzer上游标注的维护方 codefzer
分类搜索检索本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.0 KB
来自项目仓库与上游目录的原文,未做删改

Z39.50库系统MCP服务器

快速、高效的MCP(模型上下文协议)服务器,用于在多个启用Z39.50的库系统中搜索库目录。

特性

  • 快速并行搜索:使用异步I/O同时查询多个库
  • 多图书馆系统:美国国会图书馆、OCLC WorldCat、学术图书馆网络
  • 丰富的搜索选项:标题、作者、ISBN、主题、关键字搜索
  • 可用性检查:查找哪些图书馆有特定的书籍
  • 详细记录:检索全面的书目信息
  • MARC导出:下载二进制MARC、JSON或XML格式的记录
  • 结果重复数据删除:跨库智能合并结果
  • 连接池:持久连接可实现最佳性能

快速开始

安装```bash

Install dependencies

pip install -r requirements.txt


### 运行服务器```bash
# Start the MCP server
python server.py

# With debug logging
python server.py --debug

与Claude Desktop一起使用

添加到您的Claude Desktop配置中:```json
{
"mcpServers": {
"z3950": {
"command": "python",
"args": ["/path/to/Z3950/server.py"]
}
}
}


然后重新启动Claude Desktop,Z39.50工具将可用。

## 可用工具

### 搜索库

跨多个图书馆系统搜索。```
search_libraries(
query: "Harry Potter",
libraries: "loc,worldcat",        # Optional: defaults to all
query_type: "title",              # title, author, isbn, subject, keyword
max_results: 50
)

示例:

  • 按标题查找书籍: search_libraries("The Great Gatsby", query_type="title")
  • 按作者查找书籍: search_libraries("Stephen King", query_type="author")
  • 按ISBN查找: search_libraries("978-0-262-03384-8", query_type="isbn")

check_可用性

查一下哪些图书馆有书。```
check_availability(
isbn: "978-0-262-03384-8",
libraries: "loc,worldcat" # Optional: defaults to all
)


返回每个库的可用性状态和呼叫号码。

### 获取记录细节

获取全面的书目信息。```
get_record_details(
isbn: "978-0-262-03384-8",
library: "loc"
)

返回详细的元数据,包括作者、出版商、主题、出版年份等。

浏览_主题

浏览可用的主题类别。```
browse_subjects(
library: "loc",
subject_prefix: "History",
limit: 20
)


### list_librarys

获取有关可用库系统的信息。```
list_libraries()

export_marc_record

下载MARC记录供本地使用。```
export_marc_record(
isbn: "978-0-262-03384-8",
library: "loc",
format: "binary" # binary, json, or xml
)


## 可用的库

### 美国国会图书馆(loc)

- **主机**:z3950.网址:7090
- **数据库**:旅行者号
- **描述**:世界上最大的图书馆,藏书丰富

### OCLC WorldCat(世界猫)

- **主机**:z3950.oclc.org:210
- **数据库**:世界猫
- **描述**:世界上最大的图书馆目录,包含来自数千家图书馆的记录

### I-Share财团(I-Share)

- **主机**:伍芬德。卡利。伊利诺伊州。教育程度:210
- **数据库**:i-share
- **描述**:伊利诺伊州学术图书馆网络,内容来自主要大学

### 前Libris Alma(Alma模板)

- **主机**:z3950.阿拉木图图书馆集团网站:1921
- **描述**:现代图书馆管理系统(需要institution_id配置)

## 配置

库配置位于 `config/libraries.json`。要添加新库,请执行以下操作:```json
{
"my-library": {
"name": "My Library System",
"host": "z3950.mylib.edu",
"port": 210,
"database": "mylibdb",
"preferred_syntax": "USMARC",
"timeout": 5,
"max_records": 100
}
}

性能优化

服务器针对速度进行了优化:

  1. 异步并行查询:同时查询多个库
  2. 连接池:持久连接消除了握手开销
  3. 智能超时:在慢速服务器上发生快速故障时超时5秒
  4. 二进制MARC:首选格式(比JSON/XML更快)
  5. 懒惰解析:默认情况下仅提取所需字段
  6. 结果重复数据删除:O(1)通过ISBN/控制号进行重复检测
  7. 流媒体结果:增量结果交付

绩效目标:

  • 单库搜索:\<2秒
  • 多库并行搜索:\<5秒
  • 缓存命中率:\<100ms

建筑

提取的PyZ3950模块(z3950_protocol/)

从PyZ3950中提取的核心Z39.50协议实现:

  • asn1.py:ASN.1 BER编码器/解码器
  • zoom.py:用于高级查询的ZOOM API包装
  • z3950.py:核心协议实施
  • pqf.py:前缀查询格式解析器
  • zmarc.py:MARC记录解析

MCP集成层(z3950_client/)

用于高效MCP集成的定制包装:

  • connection_pool.py:异步连接管理
  • record_processor.py:快速提取MARC记录
  • query.py:查询构建和验证

MCP工具(tools/)

FastMCP工具实现:

  • search.py:并行多库搜索
  • holdings.py:可用性检查
  • details.py:完整记录检索
  • browse.py:主题浏览
  • export.py:MARC记录导出

依赖项

  • fastmcp (>=0.1.0):MCP服务器框架
  • 皮马克 (>=5.0.0):MARC记录处理
  • 层 (>=3.11):查询解析器(PLY-Python Lex Yacc)

所有Z39.50协议实现都是纯Python,没有编译依赖关系。

搜索语法

通用命令语言

该系统使用CCL进行直观搜索:

  • 标题: title=&quot;The Great Gatsby&quot;
  • 作者: author=&quot;F. Scott Fitzgerald&quot;
  • 国际标准书号: isbn=&quot;978-0-7432-7356-5&quot;
  • 主题: subject=&quot;American fiction&quot;
  • 关键词: keyword=&quot;gatsby&quot;
  • 出版商: publisher=&quot;Scribner&quot;
  • 年: year=&quot;1925&quot;

多种条件

与AND/OR结合:

  • author=&quot;Shakespeare&quot; AND title=&quot;Hamlet&quot;
  • subject=&quot;History&quot; OR subject=&quot;Biography&quot;

发展

运行测试```bash

All tests

python -m pytest tests/ -v

With performance benchmarks

python -m pytest tests/ -v --benchmark

Specific test file

python -m pytest tests/test_search.py -v


### 添加新库

1. 编辑 `config/libraries.json`
1. 测试连接: `python -c &quot;from z3950_client.connection_pool import AsyncConnectionPool; pool = AsyncConnectionPool(); print(asyncio.run(pool.test_connection(&#x27;my-lib&#x27;)))&quot;`
1. 重启服务器

### 调试模式

运行调试日志:```bash
python server.py --debug

故障排除

连接超时

  • 检查图书馆是否在线: list_libraries() 验证配置
  • 增加超时时间 config/libraries.json
  • 尝试特定库而不是全部库

未找到结果

  • 尝试不同的搜索类型(标题与关键字)
  • 检查ISBN格式(可能需要删除连字符)
  • 一些图书馆的藏书有限

MARC分析错误

  • 确保库返回USMARC格式
  • 尝试不同的查询以获取不同的记录
  • 联系库支持以进行格式配置

参考文献

  • Z39.50协议概述
  • MARC记录指南
  • PyZ3950文档
  • PyMARC文档
  • MCP文件

许可证

此项目包含从开源PyZ3950中提取的代码。请参阅各个文件头以了解归属。

贡献

要添加新功能或修复错误:

  1. 创建测试用例
  2. 实现该功能
  3. 确保所有测试通过
  4. 更新文档

支持

对于以下问题:

  • Z39.50协议:检查 PyZ3950文档
  • MARC格式:参见 美国国会图书馆MARC指南
  • MCP集成:请参阅 MCP文件

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Z3950 MCP 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

Z3950 MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Z3950 MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Z3950 MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Z3950 MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Z3950 MCP 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 Python、Claude、搜索。具体工具清单以官方文档为准。

Z3950 MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Z3950 MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。