Northwestern University Libraries Digital Collections API

dc-api-mcp

AI アシスタント向けに、Northwestern University Library の Digital Collections をツールとして提供する Model Context Protocol (MCP) サーバーです。デジタル化された図書館資料の検索、閲覧、メタデータおよび 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

ローカルへのインストールは不要です。ストリーミング可能な HTTP トランスポートを使用して、この URL に接続するよう MCP クライアントを設定してください。

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 を実行してください）。