Digital Guitar Archive MCP Server

Search and retrieve records from the Digital Guitar Archive database.

README.md

Digital Guitar Archive MCP Server

This MCP (Model Context Protocol) server provides AI assistants with tools to search and retrieve records from the Digital Guitar Archive.

The server is pre-configured to connect to the Digital Guitar Archive API at https://digitalguitararchive.com/archive/api.

Features

The server exposes three tools:

  • search_guitar_archive - Search for records with full-text search and field-specific filters
  • get_record_details - Get full details for a specific record by ID
  • list_sources - List all source libraries (RISM sigla) with record counts

Prerequisites

  • Node.js 18+ (with native fetch support)
  • npm

Installation

cd mcp
npm install
npm run build

Claude Desktop Configuration

Claude Desktop launches the MCP server automatically. Add the following to your configuration file:

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

{
    "mcpServers": {
        "guitar-archive": {
            "command": "node",
            "args": ["/path/to/mcp/dist/mcp-server.js"]
        }
    }
}

Replace /path/to/mcp/ with the absolute path to your mcp folder. For example:

macOS:

{
    "mcpServers": {
        "guitar-archive": {
            "command": "node",
            "args": ["/path/to/mcp/dist/mcp-server.js"]
        }
    }
}

After updating the configuration, restart Claude Desktop for the changes to take effect.

Development

To test the server manually:

npx ts-node src/mcp-server.ts

Note: When running with stdio transport, the server communicates via stdin/stdout and won't produce visible output. The server acts as a proxy to the live production API.

License

ISC

Tools 3

search_guitar_archiveSearch for records with full-text search and field-specific filters
get_record_detailsGet full details for a specific record by ID
list_sourcesList all source libraries (RISM sigla) with record counts

Try it

Search the Digital Guitar Archive for records related to 19th-century Spanish guitars.
Get the full details for the guitar record with ID 12345.
List all the source libraries available in the archive and show me how many records each one contains.
Find all guitar records associated with the RISM sigla 'GB-Lbl'.

Frequently Asked Questions

What are the key features of Digital Guitar Archive?

Full-text search across the Digital Guitar Archive database. Field-specific filtering for precise record retrieval. Detailed record lookup by unique identifier. Enumeration of historical source libraries and record counts.

What can I use Digital Guitar Archive for?

Musicologists researching historical guitar provenance and documentation.. Historians looking to cross-reference guitar records with RISM sigla.. Musicians exploring the historical context of specific guitar models or collections..

How do I install Digital Guitar Archive?

Install Digital Guitar Archive by running: cd mcp && npm install && npm run build

What MCP clients work with Digital Guitar Archive?

Digital Guitar Archive works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Digital Guitar Archive docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare