Wake County Public Library MCP Server

A Model Context Protocol (MCP) server that provides search capabilities for the Wake County Public Library catalog.

Features

• Search the Wake County Public Library catalog
• Search local Wake County catalog or all NC Cardinal libraries
• Returns detailed information including:
  • Title
  • Author
  • Format (book, DVD, audiobook, etc.)
  • Publication year
  • Availability status
  • Direct links to catalog entries
  • Cover images

Installation

npm install
npm run build

Usage

With Claude Desktop

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wake-county-library": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-wake-county-library/dist/index.js"]
    }
  }
}

With Other MCP Clients

Run the server using:

npm start

Or directly:

node dist/index.js

Available Tools

search_library

Search the Wake County Public Library catalog.

Parameters:

• query (string, required): The search term (book title, author, keyword, etc.)
• searchSource (string, optional):
  • "local" (default) - Search only Wake County catalog
  • "all" - Search all NC Cardinal libraries
• limit (number, optional): Maximum number of results to return (default: 10)

Example:

{
  "query": "Foundation Isaac Asimov",
  "searchSource": "local",
  "limit": 5
}

Response:

Returns an array of search results with the following structure:

[
  {
    "title": "Foundation",
    "author": "Asimov, Isaac",
    "format": "Book",
    "publicationYear": "2004",
    "availability": "Available",
    "url": "https://catalog.wake.gov/Union/Record/...",
    "coverImage": "https://..."
  }
]

Development

Building

npm run build

Testing

Run the test suite:

npm test

Run tests in watch mode:

npm run test:watch

Generate coverage report:

npm run test:coverage

The test suite includes:

• Unit tests for HTML parsing logic
• Integration tests for search functionality with mocked HTTP requests
• Tests for MCP server tool interface
• Error handling tests

Project Structure

mcp-wake-county-library/
├── src/
│   ├── index.ts              # Main MCP server implementation
│   ├── library-search.ts     # Search and parsing logic
│   └── __tests__/            # Test files
│       ├── library-search.test.ts
│       ├── server.test.ts
│       └── mocks/
│           └── searchResults.html
├── dist/                     # Compiled JavaScript output
├── coverage/                 # Test coverage reports
├── package.json
├── tsconfig.json
├── jest.config.js
└── README.md

How It Works

The server:

1. Constructs search URLs for the Wake County library catalog
2. Fetches search results using appropriate HTTP headers
3. Parses the HTML response using Cheerio
4. Extracts relevant book information from the results
5. Returns structured JSON data

License

MIT

Links

• Wake County Public Library
• Library Catalog
• Model Context Protocol