What is Neodb Mcp

neodb-mcp is a Message Control Protocol (MCP) server implementation designed for interacting with NeoDB, a social book cataloging service. It provides tools for fetching user information, searching books, and retrieving detailed book information through NeoDB’s API.

Use cases

Use cases for neodb-mcp include fetching user profiles for personalized book recommendations, searching for specific books in a catalog, and retrieving detailed information about books for display in applications.

How to use

To use neodb-mcp, first install the UV package installer, create a Python virtual environment, and install the project dependencies. You can then access various tools such as ‘get-user-info’, ‘search-books’, and ‘get-book’ to interact with the NeoDB API.

Key features

Key features of neodb-mcp include user information retrieval, book catalog searching, and detailed book information access. It supports a straightforward setup process and provides tools that require minimal parameters for operation.

Where to use

neodb-mcp can be used in applications that require integration with NeoDB for social book cataloging, such as personal library management systems, book recommendation services, and educational platforms.

NeoDB MCP Server

A Message Control Protocol (MCP) server implementation for interacting with NeoDB, a social book cataloging service. This server provides tools to fetch user information, search books, and retrieve detailed book information through NeoDB’s API.

Setup

Install UV

First, install UV package installer:

curl -LsSf https://astral.sh/uv/install.sh | sh

Create Virtual Environment

Create and activate a Python virtual environment using UV:

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate     # On Windows

Install Dependencies

Install project dependencies using UV:

uv pip install .

Available Tools

The server provides the following tools:

1. get-user-info

   • Gets current user’s basic information
   • No parameters required

2. search-books

   • Searches items in the catalog
   • Parameters:
     • query (string): Search query for books

3. get-book

   • Gets detailed information about a specific book
   • Parameters:
     • book_id (string): The ID of the book to retrieve

Usage with Claude Desktop

Get Access Token

There are two ways to get your access token:

1. Using the official guide: Follow the official documentation to obtain your access token.

2. Using automated script: You can use the neodb-get-access-token script which provides a simplified way to get your access token.

Update Config claude_desktop_config.json

{
  "mcpServers": {
    "neodb": {
      "command": "uv",
      "args": [
        "--directory",
        "<PATH_TO_PROJECT_DIR>",
        "run",
        "<PATH_TO_SCRIPT>",
        "<API_BASE> e.g. https://neodb.social",
        "<ACCESS_TOKEN>"
      ]
    }
  }
}

Where:

• <API_BASE>: The base URL for the NeoDB API
• <ACCESS_TOKEN>: Your NeoDB API access token

License

This project is licensed under the MIT License - see the LICENSE file for details.