Best Seller

畅销书——MCP多智能体故事生成器

一个基于模型上下文协议（MCP）构建的多智能体系统，能够生成完整的五章故事。主智能体协调两个专门的MCP服务器，从简单主题创作出连贯的短篇故事。

动机

我主要是将这作为一个练习，来编写基于MCP（可能是指某种特定框架或协议，如“Multi-Agent Control Protocol”等，具体需根据上下文确定）的代理程序。 使用大型语言模型（LLM）撰写一部完整的小说，主要的挑战在于，一次性完成所需的上下文信息量实在太大了。我选择的解决方案是将其分解为一系列操作，如“生成大纲”、“创作一章”等等，每一步都通过调用提示来完成。\ 网上有几个项目采用了这种方法（例如：https://github.com/adamwlarson/ai-book-writer/blob/main/outline_generator.py），但我所看到的这些项目都是基于过程式脚本，这些脚本定义了要使用的提示序列（例如，在循环中生成章节）。相反，我想要的是一个协调器代理，它能够访问一组辅助代理，每个辅助代理都提供一个作为MCP服务器暴露的服务（例如，“撰写单个章节”），然后只需让协调器来管理整个过程。

建筑学

• main_agent.py 翻译为中文是：“主代理文件.py” 或者更简洁地表述为 “主代理脚本.py” - 主协调器，负责协调故事生成
• \plot_generator_server.py\ 翻译为中文是：“图表生成器服务器.py” - 生成200字故事情节的MCP服务器
• chapter_writer_server.py 翻译为中文是：“章节编写服务器.py” 或者更简洁地表达为 “章节服务器编写器.py”，但通常我们可能会根据具体上下文选择更贴切的表述，如“章节生成服务器脚本.py”等。不过，直接翻译文件名时，“chapter_writer_server.py” 可以理解为“用于章节编写的服务器脚本.py” - MCP服务器，用于编写章节并将其保存到文件中
• mcp_agent.config.yaml 翻译为中文是：“mcp_agent配置文件.yaml” - 配置文件（未提交到git，包含敏感信息）

它是如何工作的

1. 情节生成主代理使用情节生成器根据主题创建一个整体的故事情节
2. 章节规划根据情节为5个章节创建大纲
3. 章节撰写使用章节撰写工具生成每一章（500-800字）并保存为文件
4. 输出所有章节都已保存在 chapters/ 目录

设置

1. 安装依赖项

python3.11 -m venv venv
source venv/bin/activate
pip install mcp-agent anthropic

2. 配置API密钥

复制示例配置：

cp mcp_agent.config.yaml.example mcp_agent.config.yaml

编辑 mcp_agent.config.yaml 并替换 YOUR_API_KEY_HERE 使用您的Anthropic API密钥。

您可以从以下网址获取API密钥：https://console.anthropic.com/

3. 更新配置中的路径

在 mcp_agent.config.yaml更新路径以匹配您的本地目录：

• plot_generator_server.py
• chapter_writer_server.py

使用

# Activate virtual environment
source venv/bin/activate

# Set your API key in environment
export ANTHROPIC_API_KEY='your-api-key-here'

# Generate a complete 5-chapter story
python main_agent.py "mystery, haunted lighthouse, unreliable narrator"

示例

# Mystery story
python main_agent.py "mystery, haunted lighthouse, unreliable narrator"

# Science fiction story
python main_agent.py "science fiction, time travel, dystopian future"

# Romance story
python main_agent.py "romance, second chances, small town"

# Horror story
python main_agent.py "horror, ancient curse, archaeological dig"

# Fantasy story
python main_agent.py "fantasy, magic academy, prophecy, betrayal"

输出

运行之后，你会发现：

• chapters/chapter_1.txt
• chapters/chapter_2.txt
• chapters/chapter_3.txt
• chapters/chapter_4.txt
• chapters/chapter_5.txt

每一章大约500-800字，包含完整的叙事细节。

工作流程

1. 情节生成 - 主代理调用情节生成器来创建一个连贯的200字情节
2. 章节规划 - 主代理为5个章节绘制了大纲
3. 章节撰写 - 对于每一章：

- 主要经纪人向章节作者提供情节、大纲及前一章节的概要 - 章节作者使用Claude生成详细内容 - 章节已保存至 chapters/chapter_N.txt

1. 完成 - 所有5章均已撰写并保存

文件

• main_agent.py - 主协调器代理
• plot_generator_server.py - 用于绘图生成的MCP服务器
• chapter_writer_server.py - 用于章节撰写的MCP服务器
• mcp_agent.config.yaml - 配置（已添加到git忽略文件中，包含敏感信息）
• mcp_agent.config.yaml.example - 示例配置模板
• chapters/ - 保存生成章节的目录

安全注意事项

⚠️（警告/注意） 重要永远不要提交（或：永远不要承诺） mcp_agent.config.yaml 请不要将文件推送到git，因为它包含了你的API密钥！

这个（或“该”） .gitignore 文件已配置为排除：

• mcp_agent.config.yaml
• venv/
• *.key 文件
• .env 文件