Northwestern University Libraries Digital Collections API

dc-api-mcp

一个 Model Context Protocol (MCP) 服务，将西北大学图书馆的 Digital Collections 提供为 AI 助手可用的工具。它提供用于搜索、浏览以及获取数字化馆藏资料的元数据和 IIIF 清单的工具。

可用工具

工具	描述
search	使用基于字段和／或自然语言的查询搜索作品
similarity-search	查找在视觉或语义上与指定作品相似的作品
get-work	按 ID 获取单件作品的完整元数据
view-work	查看作品的 IIIF 清单，以便在兼容的查看器中显示
list-collections	列出可用的数字馆藏
view-collection	浏览指定馆藏的 IIIF 清单
view-search-results	获取先前搜索的结果
view-similar-works	获取先前相似性搜索的结果

使用远程端点

此服务可通过以下托管远程端点使用：

https://api.dc.library.northwestern.edu/api/v2/mcp

无需本地安装。配置 MCP 客户端，使用可流式 HTTP 传输连接到此 URL。

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中。

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "dc-api": {
      "type": "http",
      "url": "https://api.dc.library.northwestern.edu/api/v2/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http dc-api https://api.dc.library.northwestern.edu/api/v2/mcp

---

开发

要求

• Node.js 24+（参见 .tool-versions）
• mise（bin/run.sh 用它来启用正确的运行时）

设置

npm install

配置

此服务读取以下环境变量：

变量	默认值	描述
DC_API_BASE	https://api.dc.library.northwestern.edu/api/v2	Digital Collections API 的基础 URL
DC_IIIF_BASE	https://iiif.dc.library.northwestern.edu/iiif/3	IIIF 服务的基础 URL
SECRETS_PATH	(none)	AWS Secrets Manager 配置的基础路径

在本地运行

stdio（适用于 Claude Desktop / Claude Code）

bun run stdio

也可以通过包装脚本运行（使用 mise 启用正确的 Node.js 版本）：

bin/run.sh

HTTP（可流式 HTTP 传输，端口 3000）

bun run http

配置 Claude Desktop（本地构建）

{
  "mcpServers": {
    "dc-api": {
      "command": "/path/to/dc-api-v2/mcp/bin/run.sh"
    }
  }
}

将 /path/to/dc-api-v2/mcp 替换为此目录的绝对路径。编辑后重启 Claude Desktop。

测试

命令	结果
bun run test	运行测试套件
bun test:watch	运行测试套件并监视更改
bun test:coverage	运行测试套件并计算覆盖率
bun test:record	使用实时数据运行测试套件并录制新的测试夹具

• 默认情况下，测试套件使用预先录制的 HTTP 测试夹具。设置 MSW_MODE=live 可使用实时数据运行。
• bun test:record 会录制新的测试夹具（需要 mitmproxy：pip install mitmproxy）。