A
licenseNot graded
qualityD
maintenanceEnables 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
Koha MCP Server
by wrecks1997
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., "@Koha MCP Server search for 'The Great Gatsby' by title"
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.
Koha MCP Server
An MCP server for searching the GBS Flexon Library catalog (Koha) and checking book availability.
Setup
Clone and install:
git clone https://github.com/wrecks1997/koha-mcp-server.git
cd koha-mcp-server
npm install
npm run buildCopy
.env.exampleto.envand fill in credentials:
cp .env.example .envAdd to Claude Code settings (
~/.claude/settings.json):
{
"mcpServers": {
"koha-library": {
"command": "node",
"args": ["/path/to/koha-mcp-server/dist/index.js"],
"env": {
"KOHA_BASE_URL": "https://staff.gbsc.bywatersolutions.com",
"KOHA_USERNAME": "your-username",
"KOHA_PASSWORD": "your-password"
}
}
}
}Related MCP server: Aspen Catalog MCP
Tools
search_books
Search the catalog by title, author, ISBN, subject, or keyword.
Parameter | Type | Required | Default | Description |
query | string | yes | — | Search term |
search_type | enum | no | keyword | title, author, isbn, subject, keyword |
limit | number | no | 10 | Max results (1-50) |
check_availability
Check item-level availability for a book.
Parameter | Type | Required | Description |
biblio_id | number | yes | Biblio ID from search results |
Development
npm run dev # Run with tsx (hot reload)
npm test # Run tests
npm run build # Compile TypeScriptAvailable Tools
2 toolscheck_availabilityARead-only
Check the availability of a specific book by its biblio_id. Returns item-level details including call number, location, and whether each copy is available or checked out.
Inputs: biblio_id (required).
search_booksARead-only
Search the GBS library catalog by title, author, ISBN, subject, or keyword. Returns matching books with biblio_id for use with check_availability.
Inputs: query (required), limit, search_type.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
A4.2/5.0
Scored across 2 tools
Disambiguation5/5
The two tools have completely distinct purposes: search_books retrieves bibliographic records, while check_availability checks item status. There is no overlap, making tool selection unambiguous.
Naming Consistency5/5
Both tool names follow the same verb_noun snake_case pattern: search_books and check_availability. The naming is consistent and intuitively indicates each tool's action and target.
Tool Count3/5
With only 2 tools, the set feels thin but is appropriate for a narrowly scoped discovery and availability-checking service. It is not excessive, but the small number limits the server's overall utility.
Completeness4/5
The search-then-check-availability workflow is fully covered with no dead ends. A minor gap is the absence of a direct fetch-by-ID tool for full bibliographic details, but the search results likely provide sufficient information for the core use case.
Maintenance
ActivityInactive
ResponsivenessOutdated data
Related MCP Connectors
Read-only search and retrieval of published books, articles and authors, with public catalog links.
Search books and authors, fetch editions, browse subjects, and resolve cover images.
Federated search of books and papers, BibTeX/RIS citations, open-access retrieval and reading.
Search a catalog of 1.7 million books and find books by mood, vibe, pace or genre. Read-only.
Related MCP Servers
- 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
- AlicenseNot gradedqualityCmaintenanceEnables searching and retrieving Project Gutenberg books by title, author, topic, and popularity, along with book details and download statistics through the Gutendex API.121 npm1MIT
- AlicenseAqualityCmaintenanceEnables searching and retrieving book details from the Kvartirabooks store/library catalog, including availability for purchase or borrowing.2MIT