快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

pip install harvard-library-mcp

详细介绍

哈佛图书馆MCP服务器

哈佛大学图书馆API目录的模型上下文协议（MCP）服务器，为人工智能助手提供全面的书目搜索和元数据检索功能。

](https://badge.fury.io/py/harvard-library-mcp) ](https://pypi.org/project/harvard-library-mcp/) ![License: MIT](https://opensource.org/licenses/MIT)

✨ 特性

🔍 综合搜索：免费文本搜索、高级现场搜索、特定收藏查询
📚 元数据：具有结构化JSON转换的原生MODS XML格式
🔌 通用集成：用于Claude Desktop、Cherry Studio和其他AI助手的stdio MCP传输
⚡ 高性能：异步HTTP客户端，内置速率限制和错误处理
🌐 访问超过2000万条记录：搜索哈佛大学全部学术图书馆藏书
📖 完整元数据：访问书目记录、主题标题和馆藏信息

🚀 快速开始

从PyPI安装

pip install harvard-library-mcp

使用AI助手

樱桃工作室集成

Cherry Studio提供原生MCP服务器支持，可与哈佛图书馆目录无缝集成。

先决条件：

Cherry Studio已安装在您的系统上
harvard-library-mcp 通过安装的软件包 pip install harvard-library-mcp

步骤1：安装MCP环境

开放樱桃工作室→ 设置→ MCP服务器
点击“安装”以自动安装所需的依赖项
如果安装失败，请手动安装到Cherry Studio目录：

- 视窗: C:\Users\{username}\.cherrystudio\bin - macOS/Linux: ~/.cherrystudio/bin

步骤2：配置哈佛图书馆MCP服务器 Cherry Studio可以使用标准的MCP配置格式。将以下内容添加到Cherry Studio MCP设置中：

{
  "mcp": {
    "servers": {
      "harvard-library": {
        "command": "uvx",
        "args": ["harvard-library-mcp"],
        "env": {}
      }
    }
  }
}

步骤3：开始使用

重新启动Cherry工作室
哈佛图书馆的工具将在您的聊天界面中提供
尝试以下查询：

- “搜索有关机器学习的书籍” - “在哈佛收藏中找到莎士比亚的作品” - “给我看看哈佛美术图书馆的记录”

Claude桌面集成

添加到您的 claude_desktop_config.json:

{
  "mcp": {
    "servers": {
      "harvard-library": {
        "command": "uvx",
        "args": ["harvard-library-mcp"]
      }
    }
  }
}

配置文件位置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

标准MCP配置

对于任何兼容MCP的客户端，请使用以下JSON配置格式：

{
  "mcp": {
    "servers": {
      "harvard-library": {
        "command": "uvx",
        "args": ["harvard-library-mcp"],
        "env": {}
      }
    }
  }
}

配置选项：

command：要运行的命令(uvx 用于从PyPI包运行）
args：包名称和其他参数(["harvard-library-mcp"])
env：服务器进程的环境变量（可选）

自定义设置示例：

{
  "mcp": {
    "servers": {
      "harvard-library": {
        "command": "uvx",
        "args": ["harvard-library-mcp"],
        "env": {
          "LOG_LEVEL": "DEBUG",
          "RATE_LIMIT_REQUESTS_PER_SECOND": "5"
        }
      }
    }
  }
}

注：使用 uvx harvard-library-mcp 是推荐的方法，因为它自动处理虚拟环境和PyPI的依赖关系。

地方发展

# Clone and install in development mode
git clone https://github.com/kltng/harvard-library-mcp.git
cd harvard-library-mcp
pip install -e .

# Run as MCP server (stdio)
python -m harvard_library_mcp.server

🛠️ 可用的MCP工具

🔍 搜索工具

search_catalog(query) -在整个哈佛图书馆目录中进行免费文本搜索
search_by_title(title) -按标题字段专门搜索
search_by_author(author) -按作者/创作者姓名搜索
search_by_subject(subject) -按主题标题和关键字搜索
advanced_search(filters) -具有特定过滤器（标题、作者、主题、日期等）的多字段搜索
search_by_collection(collection_id) -在哈佛图书馆的特定馆藏中搜索
search_by_date_range(start_date, end_date) -按发布日期范围搜索
search_by_geographic_origin(location) -按出版物位置搜索

📊 实用工具

get_record_details(record_id) -通过哈佛ID获取完整的书目记录
get_collections_list() -列出所有可用的集合及其元数据
parse_mods_metadata(mods_xml) -将MODS XML转换为结构化JSON

📝 用法示例

基本搜索

Search for books about artificial intelligence published after 2020

学术研究

Find works by Noam Chomsky in the linguistics collection
Show me details for Harvard record ID: 12345678

收藏发现

List all Harvard Library collections
Search within the Fine Arts Library collection for Renaissance art

⚙️ 配置

环境变量

HARVARD_API_BASE_URL：哈佛图书馆API的基本URL（默认值： https://api.lib.harvard.edu/v2)
RATE_LIMIT_REQUESTS_PER_SECOND：API费率限制（默认值： 10)
LOG_LEVEL：日志记录级别（默认值： INFO)

高级配置

对于自定义部署，您可以配置其他设置：

# Custom rate limiting
export RATE_LIMIT_REQUESTS_PER_SECOND=5

# Debug logging
export LOG_LEVEL=DEBUG

# Custom API endpoint (for development/testing)
export HARVARD_API_BASE_URL=https://api.lib.harvard.edu/v2

🏗️ 建筑

核心组件

服务器(server.py)：MCP stdio接口实现
API客户端(api/client.py)：哈佛图书馆API的异步HTTP客户端
工具(tools/search_tools.py)：MCP工具实现
型号(models/harvard_models.py)：用于数据验证的Pydantic模型
配置(config.py)：基于环境的配置管理

数据流

AI Assistant → MCP Server → Harvard Library API → Bibliographic Records

服务器处理：

✅ 速率限制（默认为10要求/秒）
✅ 错误处理和重试
✅ MODS XML解析和JSON转换
✅ 响应验证和键入

👨‍💻 发展

先决条件

Python 3.11或更高版本
Git

设置开发环境

# Clone the repository
git clone https://github.com/kltng/harvard-library-mcp.git
cd harvard-library-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in development mode with dependencies
pip install -e ".[dev]"

# Set up pre-commit hooks (optional)
pre-commit install

运行测试

# Run all tests
make test
pytest tests/ -v

# Run tests with coverage
make test-coverage
pytest tests/ --cov=src --cov-report=html

# Run specific test categories
pytest tests/ -m unit        # Unit tests only
pytest tests/ -m integration # Integration tests only

代码质量

# Run all linting checks
make lint
mypy src/
ruff check src/
black --check src/
isort --check-only src/

# Format code automatically
make format
black src/
isort src/
ruff check --fix src/

🐳 Docker支持

构建并运行

# Build Docker image
docker build -t harvard-library-mcp:latest .

# Run container
docker run -d --name harvard-library-mcp harvard-library-mcp:latest

# Using Docker Compose
docker-compose up -d
docker-compose logs -f

📦 安装选项

来自PyPI（推荐）

pip install harvard-library-mcp

来源

git clone https://github.com/kltng/harvard-library-mcp.git
cd harvard-library-mcp
pip install -e .

开发版本

pip install git+https://github.com/kltng/harvard-library-mcp.git

🔄 发布过程

该项目使用GitHub Actions和PyPI Trusted Publishing的自动发布。

对于用户

安装最新版本：

pip install harvard-library-mcp

安装特定版本：

pip install harvard-library-mcp==0.1.0

📄 许可证

MIT许可证-请参阅许可证文件以获取详细信息。

🔗 链接和资源

PyPI包: https://pypi.org/project/harvard-library-mcp/
GitHub存储库: https://github.com/kltng/harvard-library-mcp
错误报告: https://github.com/kltng/harvard-library-mcp/issues
哈佛图书馆API文档:

- LibraryCloud API - 图书馆云概述

MODS XML模式: http://www.loc.gov/standards/mods/

🤝 贡献

欢迎投稿！请看贡献.md 作为指导方针。

快速贡献指南

分叉存储库
创建要素分支(git checkout -b feature/amazing-feature)
提交您的更改(git commit -m 'Add amazing feature')
推到分支(git push origin feature/amazing-feature)
打开拉取请求

📊 项目统计

记录总数：2000多万条书目记录
集合：100多个专业图书馆藏书
API费率限制：10个请求/秒（可配置）
响应格式：JSON、MODS-XML
Python版本: 3.11, 3.12, 3.13
许可证：MIT

______________________________________________________________________

⭐ 如果你觉得这个仓库有用，请在GitHub上标记它！

由以下材料制成❤️ 学术研究界

目录标签

PythonClaude学术研究书目搜索本地部署元数据检索AI集成图书馆服务

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

工具数量（toolCount，工具数）

11

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/32d386f4b63c85cefecdc699c5e98cf2

哈佛大学图书馆目录API的模型上下文协议(MCP)服务器，为AI助手提供全面的书目搜索和元数据检索功能。

继续浏览同类 MCP

更多搜索检索 MCP（7,303）返回 MCP 目录

上一个 MCP

Harvard Art Museums MCP Server (Alexlin1234)

全面解析Harvard Art Museums MCP ServerMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Harvard Art Museums MCP Server能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

下一个 MCP

Harvest Natural Language Time Entry MCP Server

An MCP server for natural language time entry in Harvest

Harvard Library MCP