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:

get-user-info
- Gets current user's basic information
- No parameters required
search-books
- Searches items in the catalog
- Parameters:
  - query (string): Search query for books
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:

Using the official guide: Follow the official documentation to obtain your access token.
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.