番茄小说MCP

📦 安装与使用

✅ 本仓库已包含编译产物 build/，克隆或导入后无需自己编译即可直接运行。

🔧 方式三：从源码自行编译（仅当你改了 `src/` 源码时）

git clone https://github.com/fysh1010/mcp-server-fanqie.git
cd mcp-server-fanqie
npm install
npm run build      # 重新生成 build/

改完源码记得 npm run build 重新编译，并把 src/ 和 build/ 一起提交，否则托管平台运行的还是旧版本。

---

💻 方式二：用本地源码运行（不想用 npx 时）

仓库已含编译产物 build/，克隆后即可运行，无需编译：

git clone https://github.com/fysh1010/mcp-server-fanqie.git

配置里用 node + 你克隆后的实际绝对路径：

{
  "mcpServers": {
    "fanqie-novel": {
      "command": "node",
      "args": ["/你的克隆路径/mcp-server-fanqie/build/index.js"]
    }
  }
}

• Windows 示例（反斜杠必须双写 \\）："args": ["C:\\Users\\你的用户名\\mcp-server-fanqie\\build\\index.js"]
• macOS / Linux 示例："args": ["/Users/你的用户名/mcp-server-fanqie/build/index.js"]

⚠️ 本地绝对路径只适用于本机客户端，不要填到魔搭等云平台（云端没有这个路径）。云平台请用方式一的 npx。

---

🎯 使用示例

示例 1：搜索小说

用户：

帮我搜索关于修仙的小说

LLM 调用：

search_books(key="修仙", tab_type=3, offset=0)

返回结果：

{
  "keyword": "修仙",
  "tab_type": 3,
  "offset": 0,
  "results": [
    {
      "book_id": "7233628636023098407",
      "book_name": "修罗武神",
      "author": "善良的蜜蜂",
      "cover": "...",
      "abstract": "...",
      "total_words": 1000000
    }
    // ... 更多搜索结果
  ]
}

示例 2：获取书籍详情

用户：

帮我查看《修罗武神》的详细信息

LLM 调用：

get_book_detail(book_id="7233628636023098407")

返回结果：

{
  "book_id": "7233628636023098407",
  "detail": {
    "book_name": "修罗武神",
    "author": "善良的蜜蜂",
    "abstract": "一个关于修仙的故事...",
    "cover": "...",
    "total_words": 1000000,
    "rating": 8.5,
    "category": "玄幻"
  }
}

示例 3：获取书籍目录

用户：

帮我获取《修罗武神》的目录

LLM 调用：

get_book_directory(book_id="7233628636023098407")

返回结果：

{
  "book_id": "7233628636023098407",
  "directory": {
    "volume_1": {
      "volume_id": "xxx",
      "volume_title": "第一卷",
      "chapters": [
        {"chapter_id": "xxx", "chapter_title": "第一章"},
        {"chapter_id": "xxx", "chapter_title": "第二章"}
      ]
    }
  }
}

示例 4：阅读章节内容

用户：

我想读《修罗武神》的第一章

LLM 调用：

get_chapter_content(item_id="7233628684760910863")

返回结果：

{
  "item_id": "7233628684760910863",
  "content": "第一章的内容..."
}

示例 5：批量获取章节

用户：

帮我获取《修罗武神》前 5 章的内容

LLM 调用：

get_content(tab="batch", item_ids="章节ID1,章节ID2,章节ID3,章节ID4,章节ID5", book_id="7233628636023098407")

示例 6：获取评论

用户：

《修罗武神》有什么热门评论？

LLM 调用：

get_comments(book_id="7233628636023098407", count=10, offset=0)

运行服务器

npm run start

运行测试

npm test

使用 MCP Inspector 测试

npm run inspector

🚀 方式一：用 npx 一键配置（推荐，魔搭托管 / 本地客户端通用）

包已发布到 npm（@fysh925/mcp-server-fanqie），任何支持 MCP 的平台都用下面这一段配置——魔搭社区「可托管部署」、Claude Desktop、Cursor、Cherry Studio 全都适用：

{
  "mcpServers": {
    "fanqie-novel": {
      "command": "npx",
      "args": ["-y", "@fysh925/mcp-server-fanqie"]
    }
  }
}

• 魔搭社区：创建 MCP 服务 → 选「可托管部署」→ 配置里粘贴上面这段。魔搭云端会用 npx 自动从 npm 拉起服务，无需你自己的服务器，也无需下载代码。
• 本地客户端（Claude Desktop / Cursor / Cherry Studio）：把上面这段填进对应配置文件即可。

✅ 为什么用 npx：魔搭等平台的「可托管部署」需要从公共仓库（npm）拉起服务。npx 会自动下载并运行最新版 @fysh925/mcp-server-fanqie，这是云端托管最省心、最可靠的方式。如果填本地路径（node build/index.js），魔搭云端没有你的仓库文件，会部署失败并退化成「仅本地可用」。

部署后确认：能看到 14 个工具、调用 search_books 搜书能正常返回 —— 即成功。

各客户端配置文件位置： - Claude Desktop：claude_desktop_config.json - Cursor：~/.cursor/mcp.json 或项目内 .cursor/mcp.json - Cherry Studio：设置 → MCP 服务器 → 编辑 JSON

改完配置后需完全退出并重启客户端才生效（刷新无效）。

---

5. get_chapter_content - 获取章节内容（简单接口）

获取指定章节的文本内容。

参数： - item_id (必需): 章节 ID

返回： - 章节文本内容

6. get_content - 获取内容（统一接口）

统一的内容获取接口，支持多种内容类型。

参数： - tab (必需): 内容类型 - novel - 小说章节 - audiobook - 有声书音频 - short drama - 短剧视频 - comic - 漫画图片 - batch - 批量获取多个章节 - download - 下载整本小说 - item_id (可选): 单个章节/视频/漫画 ID（小说、听书、短剧、漫画时必需） - item_ids (可选): 多个章节 ID，逗号分隔（批量时必需） - book_id (可选): 书籍 ID（批量、下载时必需） - show_html (可选): 漫画是否返回 HTML 格式（0 或 1，默认 0） - tone_id (可选): 有声书音色 ID（听书时使用，默认 0） - async (可选): 漫画异步模式（0 或 1，默认 1，建议为 1 以获得更快响应）

使用场景： - 获取单个小说章节：tab=novel, item_id=章节ID - 获取有声书音频：tab=audiobook, item_id=章节ID - 获取漫画图片：tab=comic, item_id=章节ID - 批量获取章节：tab=batch, item_ids=章节ID1,章节ID2, book_id=书籍ID - 下载整本小说：tab=download, book_id=书籍ID

⚙️ 自定义 API 地址（可选）

服务默认使用内置接口地址 http://101.35.133.34:5000。若该地址日后变更，可通过环境变量 FANQIE_API_BASE 覆盖，无需改代码：

{
  "mcpServers": {
    "fanqie-novel": {
      "command": "npx",
      "args": ["-y", "@fysh925/mcp-server-fanqie"],
      "env": {
        "FANQIE_API_BASE": "http://新的接口地址:端口"
      }
    }
  }
}

也可在项目根目录创建 .env 文件：FANQIE_API_BASE=http://101.35.133.34:5000