drio
Open app

NeoDB MCP Server

Source

A Message Control Protocol (MCP) server implementation for interacting with [NeoDB](

Catalog onlyCatalog onlySTDIO

Overview

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

To use the NeoDB MCP Server, you need to set it up by installing the UV package installer, creating a virtual environment, and installing the necessary dependencies. After setup, you can interact with the server using various tools provided.

  • Fetch current user's basic information with the get-user-info tool. - Search for books in the catalog using the search-books tool. - Retrieve detailed information about specific books with the get-book tool.
  1. Users can obtain their profile information from NeoDB.
  2. Developers can integrate book search functionality into their applications.
  3. Researchers can analyze book data from the NeoDB catalog.

Add to your AI client

Use these steps to connect NeoDB MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "neodb-mcp-xytangme": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-neodb-mcp-xytangme"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "neodb-mcp-xytangme": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-neodb-mcp-xytangme"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "neodb-mcp-xytangme": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-neodb-mcp-xytangme"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "neodb-mcp-xytangme": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-neodb-mcp-xytangme"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "neodb-mcp-xytangme": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-neodb-mcp-xytangme"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "neodb-mcp-xytangme": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-neodb-mcp-xytangme"
      ]
    }
  }
}

FAQ

How do I get my access token?

You can obtain your access token by following the official documentation or using the automated script provided in the repository.

What programming language is used for this project?

The NeoDB MCP Server is implemented in Python.

Is there a license for this project?

Yes, this project is licensed under the MIT License.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1103,"uuid":"fc6ff467-175c-466f-9936-3ee052d2e0cd","name":"neodb-mcp","title":"NeoDB MCP Server","description":"A Message Control Protocol (MCP) server implementation for interacting with [NeoDB](","avatar_url":"https://avatars.githubusercontent.com/u/73456774?v=4","created_at":"$D2025-01-28T02:31:52.383Z","updated_at":"$D2025-02-23T07:12:47.867Z","status":"created","author_name":"xytangme","author_avatar_url":"https://avatars.githubusercontent.com/u/73456774?v=4","tags":"neodb,mcp,server,api,book-cataloging","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/xytangme/neodb-mcp","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/fe93ffdb9101c859d9d6890093e3757bb38184f8767cbfe0e7df2a8e6492e042/68747470733a2f2f676c616d612e61692f6d63702f736572766572732f31616e79336565617a612f6261646765","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Research and data