NeoDB MCP Server

What is NeoDB MCP Server?

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

How to use NeoDB MCP Server?

Install UV and create a Python virtual environment, then install dependencies with uv pip install .. Obtain a NeoDB API access token (via official documentation or an automated script) and configure Claude Desktop by updating claude_desktop_config.json with the command uv and the appropriate arguments (API base URL and access token).

Key features of NeoDB MCP Server

• Fetch current user’s basic information
• Search books in the NeoDB catalog
• Retrieve detailed book information by ID
• Integrates directly with NeoDB’s API
• Works with Claude Desktop via MCP

Use cases of NeoDB MCP Server

• Query your own NeoDB profile and library data
• Search for books by title or keyword
• Get detailed metadata for a specific book
• Build a personal assistant that interacts with your book catalog

FAQ from NeoDB MCP Server

How do I get an access token for NeoDB?

You can obtain an access token by following the official NeoDB API documentation, or by using the automated neodb-get-access-token script linked in the README.

How do I configure NeoDB MCP Server with Claude Desktop?

Edit claude_desktop_config.json to add an MCP server entry with command uv and arguments including the project directory, script path, API base URL, and your access token. Example configuration is provided in the README.

What tools does NeoDB MCP Server provide?

Three tools: get-user-info (no parameters), search-books (requires a query string), and get-book (requires a book ID string).

What are the runtime dependencies?

The server requires Python, UV (package installer), and a virtual environment. Dependencies are installed via uv pip install ..