CONTENTdm State Archives MCP Server

by iandersoio.github.ianderso/contentdm-mcpv0.1.0

Search US state archives' record images on CONTENTdm; read items, pages and transcripts.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install CONTENTdm State Archives MCP server

claude mcp add contentdm -- uvx contentdm-mcp

{
  "mcpServers": {
    "contentdm": {
      "command": "uvx",
      "args": [
        "contentdm-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "contentdm": {
      "command": "uvx",
      "args": [
        "contentdm-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "contentdm": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "contentdm-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "contentdm": {
      "command": "uvx",
      "args": [
        "contentdm-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Variable	Required	Secret	Description
CONTENTDM_CACHE_DIR	—	—	Directory for the on-disk response cache.
CONTENTDM_TIMEOUT	—	—	HTTP timeout in seconds for one request. Image downloads get 120 s to read.
CONTENTDM_MIN_INTERVAL	—	—	Least seconds between two requests to one site. Never below 0.5.
CONTENTDM_CONTACT	—	—	An email address or URL appended to the User-Agent, so an institution can reach whoever runs the server.
CONTENTDM_EXTRA_INSTANCES	—	—	More CONTENTdm sites a tool may reach, beyond the curated ones and *.contentdm.oclc.org: https base URLs separated by commas, or the absolute path of a YAML file shaped like instances.yaml.
CONTENTDM_DOWNLOAD_DIR	—	—	An existing folder. When set, get_image saves only inside it; needed to save under ~/Library, such as an iCloud Drive folder.