# wuming-books (无名图书) MCP Server & Agent Skill

[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.delicious28%2Fwuming--books-blue)](https://github.com/modelcontextprotocol/registry)
[![Smithery](https://img.shields.io/badge/Smithery-delicious28%2Fwuming--books-green)](https://smithery.ai/servers/delicious28/wuming-books)
[![Cursor Directory](https://img.shields.io/badge/Cursor%20Directory-wuming--books-black)](https://cursor.directory/plugins/wuming-books)

**[无名图书 (wuming-books)](https://www.book345.com)** is a free, remote [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server by [book345.com](https://www.book345.com) that gives AI assistants the ability to **search Chinese books**, read book details with Douban ratings, access AI-generated book guides (editor reviews, core points, reader consensus, chapter abstracts), and browse curated toplists.

📖 **Website & documentation: [https://www.book345.com/mcp](https://www.book345.com/mcp)**
🧩 **Agent Skill: [https://www.book345.com/skill](https://www.book345.com/skill)** · [SKILL.md](skill/SKILL.md)

## Why wuming-books

- **680K+ Chinese books** with metadata aggregated from public sources (title, author, publisher, ISBN, Douban rating, pages, price, catalog)
- **AI book guides** unique to book345.com — "what is this book about and is it worth reading?" answered in one call
- **Curated toplists** — top-rated, hidden gems, new releases, weekly updates, and category charts (tech, history, career, law, social science)
- **Free & no API key** — zero-configuration remote server
- Every result links back to the corresponding page on [book345.com](https://www.book345.com)

## Quick start

The endpoint is a Streamable HTTP MCP server:

```
https://www.book345.com/api/mcp
```

### Claude Code

```bash
claude mcp add --transport http wuming-books https://www.book345.com/api/mcp
```

### Claude Desktop / Cursor / any MCP client (mcp.json)

```json
{
  "mcpServers": {
    "wuming-books": {
      "url": "https://www.book345.com/api/mcp"
    }
  }
}
```

### Smithery (one-click install)

```
https://smithery.ai/servers/delicious28/wuming-books
```

## Tools

| Tool | Description |
|---|---|
| `search_books` | Search by title, author, ISBN or keyword; filter by 16 categories (文学, 计算机, 历史, …) |
| `get_book_detail` | Full book details: author, publisher, pages, price, Douban rating, tags, summary, catalog |
| `get_book_guide` | AI guide: editor review, core points, reader consensus, chapter abstracts, short comments |
| `get_toplist` | Curated toplists: `top` / `cold` / `new` / `weekly` / `law` / `social` / `career` / `history` / `tech` |
| `get_recent_hot` | Recently hot updated books, optionally filtered by category |
| `list_book_tags` | List all categories with page links |

Example — ask your assistant:

> "Search for highly-rated books about behavioral economics on 无名图书"

## Agent Skill

Prefer an [Agent Skill](https://agentskills.io) over an MCP connection? A single-file skill teaches your AI to call the public HTTP APIs directly (and to use the MCP tools when available):

```bash
mkdir -p ~/.claude/skills/wuming-books && curl -fsSL https://www.book345.com/skill/wuming-books/SKILL.md -o ~/.claude/skills/wuming-books/SKILL.md
```

See [`skill/SKILL.md`](skill/SKILL.md).

## Registry entries

This server is published to the official MCP Registry. [`server.json`](server.json) is the source of truth for registry metadata.

| Registry | Name |
|---|---|
| [MCP Registry](https://github.com/modelcontextprotocol/registry) | `io.github.delicious28/wuming-books` |
| [Smithery](https://smithery.ai/servers/delicious28/wuming-books) | `delicious28/wuming-books` |
| [Cursor Directory](https://cursor.directory/plugins/wuming-books) | `wuming-books` |

## Rate limits & fair use

- 60 requests/minute per IP
- Data is for discovery and reading guidance; book345.com does not host or distribute e-book files
- Rights holders: takedown requests via contact@book345.com, handled within 24h

## License

[MIT](LICENSE) for the client-side code and documentation in this repository. Data served by the API is © its respective sources; see [book345.com/about](https://www.book345.com/about) for details.