Skip to main content
Glama
Sign In
webnovel-mcp

webnovel-mcp

by minhmc2007
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

WebNovel MCP

MCP server that reads web novels from webnovel.com. Search by title, browse chapters, read content — all through MCP tools.

Install

uv add fastmcp cloudscraper beautifulsoup4

Or clone and install:

git clone https://github.com/minhmc2007/WebNovel-MCP.git
cd WebNovel-MCP
uv sync

Related MCP server: google-surf-mcp

Configure

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "webnovel": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/WebNovel-MCP", "webnovel-mcp"]
    }
  }
}

Tools

Tool

Description

search_novels(query, page)

Search by keyword. Returns 20 results per page with bookId, title, author, genre, rating.

get_novel_by_name(name)

Quick lookup — returns top match with bookId and next-step instructions.

get_novel_info(book_id)

Full metadata: title, author, description, chapter count, first chapter ID.

get_chapter_list(book_id)

Table of contents with chapter IDs and titles.

read_chapter(book_id, chapter_id)

Full chapter text.

Usage

Typical flow:

  1. search_novels("solo leveling") — find the novel

  2. get_chapter_list(book_id) — pick a chapter

  3. read_chapter(book_id, chapter_id) — read it

Or skip to get_novel_by_name("solo leveling") for the bookId directly.

How It Works

┌─────────────────────────────────────────────────────┐
│                  MCP Client                         │
│            (Claude, Cursor, etc.)                   │
└──────────────────────┬──────────────────────────────┘
                       │ stdio (JSON-RPC)
                       ▼
┌─────────────────────────────────────────────────────┐
│              webnovel-mcp server                    │
│                                                     │
│  ┌───────────┐  ┌────────────┐  ┌───────────────┐  │
│  │  search   │  │   novel    │  │    chapter    │  │
│  │  _novels  │  │   _info    │  │   _list /     │  │
│  │           │  │            │  │   read_chapter│  │
│  └─────┬─────┘  └─────┬──────┘  └──────┬────────┘  │
│        │              │                │            │
│        ▼              ▼                ▼            │
│  ┌─────────────────────────────────────────────┐    │
│  │           cloudscraper session              │    │
│  │   (bypasses Cloudflare, manages cookies)    │    │
│  └─────────────────────┬───────────────────────┘    │
└────────────────────────┼────────────────────────────┘
                         │ HTTPS
                         ▼
┌─────────────────────────────────────────────────────┐
│               webnovel.com                          │
│                                                     │
│  /go/pcm/search/result     ← search API (JSON)     │
│  /book/{id}/catalog        ← catalog page (HTML)   │
│  /book/{id}/{chapter_id}   ← chapter page (HTML)   │
└─────────────────────────────────────────────────────┘

Search hits the JSON API at /go/pcm/search/result with a CSRF token. Returns structured data — bookId, title, author, genre, rating.

Chapter list scrapes the catalog HTML page. Chapter IDs are extracted from <a href> tags (pattern: ..._chapterId). No encrypted API needed.

Chapter reading scrapes the chapter HTML page. Content lives in .cha-words elements as <p> tags. Free chapters only — locked chapters return a message.

All requests go through cloudscraper which handles Cloudflare's bot challenge automatically.

Limits

  • Free chapters only. VIP/locked chapters behind paywall.

  • Rate limiting is Cloudflare's call, not the API's. Slow down if you get blocked.

  • No authentication — works without login for free content.

License

MIT

Available Tools

5 tools
get_chapter_listGet Chapter ListA

Get the full table of contents for a novel.

Inputs: book_id (required). Returns: result

get_novel_by_nameGet Novel By NameB

Quick search: find a novel by name and return book_id with first chapter.

Inputs: name (required). Returns: result

get_novel_infoGet Novel InfoB

Get detailed info about a novel (title, author, chapter count, first chapter).

Inputs: book_id (required). Returns: result

read_chapterRead ChapterA

Read the full content of a chapter.

Inputs: book_id (required), chapter_id (required). Returns: result

search_novelsSearch NovelsB

Search for web novels by title or keyword.

Inputs: query (required), page. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation2/5

    search_novels and get_novel_by_name overlap heavily, as both find novels by name/title. get_novel_by_name also returns the first chapter, blurring the boundary with get_novel_info and read_chapter.

    Naming Consistency4/5

    Most tools follow a clear verb_noun pattern like search_novels, get_novel_info, and read_chapter. get_novel_by_name is slightly less consistent because of its prepositional modifier, but it remains readable and predictable.

    Tool Count5/5

    Five tools is well-scoped for a web novel browsing and reading server. Each tool covers a distinct step in the discovery-to-reading workflow without unnecessary bloat.

    Completeness4/5

    The core workflow is covered: search, get novel details, list chapters, and read chapter content. Minor conveniences like getting the next chapter or latest updates are absent, but the main reading experience has no dead ends.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-server-fanqie

      fysh1010
      A
      license
      B
      quality
      C
      maintenance
      Enables searching and reading novels from FanQie Novel platform through MCP, supporting book details, chapters, comments, and multi-type content retrieval.
      14
      57 npm
      57
      MIT

    • google-surf-mcp

      tamir-ariunsukh
      A
      license
      A
      quality
      B
      maintenance
      Provides Google search, URL extraction, and academic paper inline extraction without API keys, enabling search and content retrieval from a single MCP server.
      5
      593 npm
      MIT

    • mu-ebook-scout

      muippt
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables multi-source search and verified download of public-domain and open-license ebooks (Chinese/English) through a unified MCP interface.
      2
      MIT

    • qimao-autopub-mcp

      yangmi829
      A
      license
      A
      quality
      B
      maintenance
      Enables authors to automate publishing and managing their own Qimao (七猫) novel author-backend works through an MCP client, covering login and status, book creation and metadata, chapter add/edit/delete and batch publishing, short stories, read-only statistics and income, plus a local manuscript library, originality checks, and a genre knowledge base. Write operations follow a two-stage preview-then-confirm flow and it runs over stdio or Streamable HTTP with 30 tools and 8 read-only resources.
      30
      43 npm
      MIT