内容
网文MCP免费版
**一款免费、开源的MCP服务器，用于规划、编写和管理网文项目，配备AI助手。**
支持 **仙侠**、**LitRPG**、**进步幻想**、**浪漫**、**同人小说** 等所有连载小说格式。与任何兼容MCP的客户端（Claude Desktop、Windsurf、Cursor、Cline、Roo等）配合使用。
---
## 它能做什么？
这个MCP服务器通过以下方式帮助您编写网文：
- **组织您的作品** — 创建具有人物、章节和世界构建文件夹的项目结构
- **跟踪人物** — 存储人物卡片，记录人物名称、角色、形象，并跟踪人物随时间的变化
- **管理章节** — 创建章节大纲，保存已写的章节，跟踪字数
- **构建世界** — 保存地点、派系、魔法系统、文化和传说
- **伏笔跟踪器** — 跟踪数百章中种植的伏笔和计划的回报
- **连续性检查器** — 扫描项目中是否有逾期的伏笔、停滞的人物和章节空白
- **时间线跟踪器** — 使用事件、日期和时间跳转管理故事时间线
- **LitRPG统计块** — 完整的RPG人物跟踪（等级、统计数据、技能、库存、装备、任务）
- **浪漫弧线跟踪器** — 跟踪关系阶段、浪漫时刻和慢燃弧线的节奏
- **项目导出** — 生成用于备份和共享的综合项目摘要
- **写作提示** — 用于章节写作、人物创建、弧线规划和头脑风暴的引导提示
---
## 快速入门指南（适用于非技术用户）
**无需担心技术细节 — 只需告诉您的AI助手：**
> “请帮助我设置webnovel-mcp服务器。我想从https://github.com/netflypsb/webnovel-free-mcp下载它，安装它，并为我的MCP客户端配置它。”
您的AI助手将为您处理所有设置。
---
## 分步手动安装
如果您更喜欢自己动手或您的AI需要指导，请按照以下步骤：
### 步骤1：下载服务器
**选项A：下载ZIP（最简单）**
1. 前往：https://github.com/netflypsb/webnovel-free-mcp
2. 点击绿色 **“代码”** 按钮
3. 选择 **“下载ZIP”**
4. 将ZIP文件解压到计算机上的文件夹中（例如，Windows上的 `C:\webnovel-mcp` 或Mac/Linux上的 `~/webnovel-mcp`）
**选项B：使用Git（如果已安装Git）**
```bash
git clone https://github.com/netflypsb/webnovel-free-mcp.git
cd webnovel-free-mcp
```
### 步骤2：安装Python（如果尚未安装）
1. 前往 https://python.org/downloads
2. 下载Python 3.10或更新版本
3. 运行安装程序
4. **Windows上重要：** 勾选“将Python添加到PATH”
### 步骤3：安装服务器
在下载的文件夹中打开终端/命令提示符并运行：
**Windows：**
```powershell
pip install -e .
```
**Mac/Linux：**
```bash
pip3 install -e .
```
或者，如果您已安装 `uv` （更快）：
```bash
uv pip install -e .
```
### 步骤4：配置MCP客户端
将以下内容添加到MCP客户端配置中**对于Claude Desktop：**
- 编辑：`%APPDATA%\Claude\claude_desktop_config.json`（或 `~/Library/Application Support/Claude/claude_desktop_config.json`（Mac）
```json
{
"mcpServers": {
"web-mcp": {
"command": "python",
"args": ["-m", "webnovel_mcp.server"]
}
}
}
```
**对于Windsurf：**
- 编辑：`~/.codeium/windsurf/mcp_config.json`（Mac）或 `%USERPROFILE%\.codeium\windsurf\mcp_config.json`（
```json
{
"mcpServers": {
"webnovel-mcp": {
"command": "python",
"args": ["-m", "webnovel_mcp.server"]
}
}
}
```
**对于Cursor：**
- 进入设置 → MCP → 添加服务器
- 命令：`python -m webnovel_mcp.server`
**对于Cline/Roo（VS Code）：**
- 编辑：工作区中的 `.vscode/mcp.json`
```json
{
"servers": {
"webnovel-mcp": {
"command": "python",
"args": ["-m", "webnovel_mcp.server"],
"env": {}
}
}
}
```
### 步骤5：重启AI客户端
关闭并重新打开AI助手客户端以加载新工具。
---
## 如何使用
设置完成后，您可以使用自然语言与AI助手：
**创建新小说：**
> “创建一个名为‘不朽之路’的仙侠网文，作者是我。”
**创建人物：**
> “创建主人公林魏，一个来自贫穷村庄的16岁修炼者。”
**构建世界：**
> “为青天门创建一个世界入口，一个主要的修炼门派。”
**编写章节：**
> “用林魏发现神秘神器的精彩开头写第一章。”
**跟踪伏笔：**
> “跟踪这个伏笔：林魏找到的玉佩将在第50章被揭露为门派创始人的令牌。”
**检查连续性问题：**
> “运行连续性检查，看看我是否有情节漏洞或遗忘的伏笔。”
您的AI将自动使用适当的工具！
---
## 可用工具（全部免费）
| 工具 | 描述 |
|------|-------------|
| `init_project` | 搭建完整的网文项目 |
| `get_project_status` | 查看项目状态和进度 |
| `create_character` | 创建人物卡片 |
| `get_character` | 读取人物卡片 |
| `list_characters` | 列出所有人物 |
| `update_character` | 更新人物属性 |
| `create_chapter_outline` | 生成章节大纲 |
| `save_chapter` | 保存已编写的章节 |
| `get_chapter` | 读取章节 |
| `list_chapters` | 列出所有章节 |
| `create_world_entry` | 创建世界构建条目 |
| `get_world_entry` | 读取世界构建条目 |
| `list_world_entries` | 列出世界构建条目 |
get_style_guide`写作风格指南 |
| `track_foreshadowing` | 跟踪种植的伏笔和计划的回报 |
| `getadowing_report` | 查看状态报告 |
| `run_continuity_check` |连续性问题 |
|_timeline` | 添加条目 |
| `get_timeline` | 查看故事时间线 |
| `create_litrpg_stats` | 创建LitRPG统计块 |
| `updatepg_stats` | 更新LitRPG统计数据 |
| `create_romance_tracker` | 创建浪漫弧线跟踪器 |
| `update_romance_tracker` | 更新浪漫进展 |
| `export_project_summary` | 导出项目摘要 |
---
## 项目结构
当您创建一个项目时，它看起来像这样：
```
your-novel/
├── novel.json # 项目配置
├── litconfig.json 结构化元数据
├── outline.md # 故事大纲
├── characters/ # 人物卡片
/ # 章节├── worldbuilding/ 构建条目
├── arcs/ # 弧线大纲
└── metadata/ # 跟踪文件
```
---
## 资源
| URI | 描述 |
|-----|-------------|
| `template://novel-config` | novel.json 模板 |
| `template://litconfig` | litconfig.json 模板 |
| `template://character-sheet` | 人物卡片模板 |
| `template://chapter-structure` | 章节结构模板 |
| `template://world-state` | 世界状态模板 |
|://style-guide` | 写作风格指南 |
---
##
| 提示 | 描述 |
|--------|-------------|
| `write-chapter` | 带有连续性检查的引导式章节写作 |
| `create-character` | 引导式 |
| `plan-arc` | 弧线规划 |
| `brainstorm-story` | 故事概念头脑风暴 |
---
##排除
**“未找到错误：**
- 确保已安装Python并添加到- 尝试在上使用 `python3` 代替 `python`
**“模块未找到”错误：**
- 确保在正确的文件夹中运行了 `pip install -e .`
- 尝试：`pip install m 和 `pip install[cli]`
**中未显示工具： 完全重启AI- 检查MCP配置文件中的路径是否正确
- 在日志中查找错误消息
**Mac/Linux上的权限错误：**
- 您可能需要使用 `sudo pip3 install -e .` （不推荐）
- 更好：使用虚拟`python3 -m venv .venv && source .venv/bin/activate && pip install -e .`
---
## 许可证
MIT许可证。详情请参见 [LICENSE](LICENSE)。
链接
-Hub仓库：** https://github.com/netflypsbel-free-mcp
- **模型上下文协议：** https://modelcontextprotocol.io
- **原始仓库（带有市场版本）：** https://github.com/netflypsb/webnovel-mcp
---
## 获取帮助
如果您需要帮助设置：
1. **询问您的AI助手** — “请帮助我从https://github.com/netflypsb/webnovel-free-mcp设置webnovel-mcp服务器。”
2. **在GitHub上打开问题：** https://github.com/netflypsb/webnovel-free-mcp/issues
3. **查看原始仓库** 以获取更多文档： https://github.com/netflypsb/webnovel-mcp
---
**祝您写作愉快！**
