# Neodb Mcp

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-xytangme-neodb-mcp`
- **Verified:** Pending review
- **Seller:** [xytangme](https://agentstack.voostack.com/s/xytangme)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [xytangme](https://github.com/xytangme)
- **Source:** https://github.com/xytangme/neodb-mcp

## Install

```sh
agentstack add mcp-xytangme-neodb-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# NeoDB MCP Server

A Message Control Protocol (MCP) server implementation for interacting with [NeoDB](https://neodb.social/), 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:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

### Create Virtual Environment
Create and activate a Python virtual environment using UV:

```bash
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate     # On Windows
```

### Install Dependencies
Install project dependencies using UV:

```bash
uv pip install .
```

## 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](https://neodb.net/api/) to obtain your access token.

2. Using automated script: You can use the [neodb-get-access-token](https://github.com/xytangme/neodb-get-access-token) script which provides a simplified way to get your access token.

### Update Config `claude_desktop_config.json`

```json
{
  "mcpServers": {
    "neodb": {
      "command": "uv",
      "args": [
        "--directory",
        "",
        "run",
        "",
        " e.g. https://neodb.social",
        ""
      ]
    }
  }
}
```

Where:
- ``: The base URL for the NeoDB API
- ``: Your NeoDB API access token

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [xytangme](https://github.com/xytangme)
- **Source:** [xytangme/neodb-mcp](https://github.com/xytangme/neodb-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-xytangme-neodb-mcp
- Seller: https://agentstack.voostack.com/s/xytangme
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.