Wake County Public Library
Search the Wake County Public Library catalog for books, media, and other materials using keywords, titles, or authors.
Search library catalogs: Query for books, DVDs, audiobooks, and other materials using keywords, titles, or author names
Flexible search scope: Choose between searching only Wake County libraries or all NC Cardinal libraries across North Carolina
Detailed results: Get comprehensive information including title, author, format, publication year, availability status, direct catalog links, and cover images
Configurable results: Control the number of results returned (default: 10)
MCP integration: Works with Claude Desktop and other MCP-compatible applications, providing structured JSON output for easy integration
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Wake County Public Library find available copies of The Hobbit in audiobook format"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Wake County Public Library MCP Server
A Model Context Protocol (MCP) server that provides search capabilities for the Wake County Public Library catalog.
Built with Python using the official MCP Python SDK and uv for dependency management.
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
Related MCP server: Aspen Catalog MCP
Prerequisites
Python 3.12 or higher
uv - Fast Python package manager
Installing uv
# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# Or with pip
pip install uvInstallation
# Clone the repository
git clone <repository-url>
cd mcp-wcpl
# Install dependencies
uv syncUsage
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": "uv",
"args": [
"--directory",
"/absolute/path/to/mcp-wcpl",
"run",
"python",
"-m",
"mcp_wcpl"
]
}
}
}Replace /absolute/path/to/mcp-wcpl with the actual path to this project directory.
Running Directly
You can also run the server directly for testing:
# Using uv (recommended)
uv run python -m mcp_wcpl
# Or activate the virtual environment first
source .venv/bin/activate # Unix/macOS
.venv\Scripts\activate # Windows
python -m mcp_wcplAvailable 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
Testing
Run the test suite:
# Run all tests
uv run pytest
# Run with verbose output
uv run pytest -v
# Run with coverage report
uv run pytest --cov=src/mcp_wcpl --cov-report=html
# Run specific test file
uv run pytest tests/test_server.pyThe test suite will include:
Unit tests for HTML parsing logic
Integration tests for search functionality with mocked HTTP requests
Tests for MCP server tool interface
Error handling tests
Adding Dependencies
# Add a runtime dependency
uv add <package-name>
# Add a development dependency
uv add --dev <package-name>Project Structure
mcp-wcpl/
├── src/
│ └── mcp_wcpl/ # Main package
│ ├── __init__.py # Package initialization
│ ├── __main__.py # Entry point
│ └── server.py # MCP server implementation
├── tests/ # Test files
│ ├── __init__.py
│ └── test_server.py
├── .venv/ # Virtual environment (created by uv)
├── pyproject.toml # Project configuration
├── uv.lock # Dependency lock file
├── .gitignore
├── README.md
└── CLAUDE.md # Instructions for Claude CodeHow It Works
The server will:
Construct search URLs for the Wake County library catalog
Fetch search results using httpx with appropriate HTTP headers
Parse the HTML response using BeautifulSoup4
Extract relevant book information from the results
Return structured JSON data via the MCP protocol
License
MIT
Links
Available Tools
1 toolsearch_libraryB
Search the Wake County Public Library catalog for books, media, and other materials. Returns information about items including title, author, format, availability, and links to the catalog.
Inputs: query (required), limit, searchSource.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion between tools.
The single tool follows a clear verb_noun pattern (search_library), so consistency is perfect.
One tool is on the low end but acceptable for a focused search server; however, the server name implies a broader library scope.
Only a search tool is provided, lacking essential operations like fetching item details, browsing, or account management, which are typical for a library server.
Maintenance
Related MCP Connectors
Read-only search and retrieval of published books, articles and authors, with public catalog links.
Search books and authors across Open Library, the Internet Archive open catalog.
Search a catalog of 1.7 million books and find books by mood, vibe, pace or genre. Read-only.
Federated search of books and papers, BibTeX/RIS citations, open-access retrieval and reading.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables searching the National Library Board Singapore catalogue by title, author, ISBN, or subject, and checking real-time availability of books across library branches.Apache 2.0
- AlicenseBqualityDmaintenanceEnables AI clients to search Aspen Discovery library catalogs and check real-time book availability by keyword, author, or ISBN. This server allows users to verify local library inventory and filter book recommendations accordingly.26 npmMIT
- AlicenseAqualityDmaintenanceEnables searching the GBS Flexon Library catalog (Koha) and checking book availability.22MIT
- FlicenseNot gradedqualityDmaintenanceEnables searching WorldCat's library catalog for bibliographic records, editions, citations, and exports in various formats via natural language.-