nlib

This MCP server, nlib-mcp-server, provides a library catalog search capability that leverages the Cariru Unitrad API for searching holdings. The server exposes the nlib_search_books function, which lets you query the library catalogue and retrieve matching book records. Access to Cariru's enterprise API is available under a paid license; this server is configured to demonstrate the search workflow for testing purposes. To use it, deploy the MCP server and then invoke the nlib_search_books tool to perform search queries (e.g., by title, author, or keyword) and receive structured results that can be consumed by your client or automation workflow. The server is primarily focused on search functionality, with the nlib_search_books feature currently marked as a to-do in the project plan but wired for use once enabled.

Prerequisites:

• Ensure you have the uv (uvx) CLI installed and available in your PATH.
• Access to the Cariru Unitrad API with a valid license (for testing, use provided access as described in the project notes).
• Basic Node/Python environment is not required for this server since it is intended to be run via the uvx CLI as shown.

Steps:

1. Install the uvx tool if you haven't:
   • Follow the official installation instructions for uvx for your OS.
2. Install the MCP server package via uvx:
   • Run: uv install
3. Install the MCP server configuration:
   • Run: uv run mcp install
4. Start the MCP server:
   • Run: uv run mcp start
5. Verify the server is running and accessible at the configured endpoint, then test the nlib_search_books capability once the feature is enabled in your license context.

Tips and caveats:

• The Cariru Unitrad API access used by this server is restricted to licensed use; ensure your license is active and properly configured in the environment.
• The nlib_search_books feature is listed as a to-do in the repository; depending on the build, you may need to enable or implement the endpoint before live usage.
• If you encounter connectivity issues with the Cariru API, verify network access, API endpoint whitelisting, and credentials.
• Use environment variables to configure API keys, endpoints, and license tokens as needed by your deployment. Example env vars: API_BASE_URL, API_LICENSE_TOKEN, API_CLIENT_ID, API_CLIENT_SECRET.
• For debugging, run the MCP server with verbose logging enabled if your uvx CLI supports a log level flag or environment variable.