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:

Create Virtual Environment

Create and activate a Python virtual environment using UV:

Install Dependencies

Install project dependencies using UV:

Related MCP server: Yonote MCP Server

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

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.