Koha Server

An MCP server for searching the GBS Flexon Library catalog (Koha) and checking book availability.

Setup

1. Clone and install:

git clone https://github.com/wrecks1997/koha-mcp-server.git
cd koha-mcp-server
npm install
npm run build

2. Copy .env.example to .env and fill in credentials:

cp .env.example .env

3. Add 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"
      }
    }
  }
}

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 TypeScript