NeoDB MCP Server

@xytangme

Repository

Basic information

About NeoDB MCP Server

A Message Control Protocol (MCP) server implementation for interacting with [NeoDB](https://neodb.social/)

#neodb#mcp #server #api#book-cataloging

NeoDB MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "neodb-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

NeoDB MCP Server tools

`query` (string): Search query for books

`book_id` (string): The ID of the book to retrieve

Overview

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

Frequently asked questions

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 .`.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.