Book Teardown MCP Server

一个基于 Model Context Protocol (MCP) 的电子书结构化深度拆解服务。

功能特性

• 支持多种电子书格式：PDF、Markdown、纯文本
• 支持本地文件、Base64 内容、远程 URL 输入
• 结构化拆解输出：
  • 核心矛盾解析
  • 底层逻辑梳理
  • 关键洞察提取
  • 心智模型提炼
  • 可执行行动清单
  • 金句卡片
  • 批判性分析
  • Mermaid 流程图

安装

npm install book-teardown-mcp

配置

环境变量

创建 .env 文件或设置以下环境变量：

# LLM API Keys（必需）
GLM5_API_KEY=your_glm5_api_key
KIMI_API_KEY=your_kimi_api_key

# 可选：自定义 API 端点
GLM5_BASE_URL=https://open.bigmodel.cn/api/paas/v4
KIMI_BASE_URL=https://api.moonshot.cn/v1

# 可选：鉴权配置
SKILL_KEY=your_skill_key
SKILL_VERIFY_URL=https://api.skillmarket.io/v1/verify
SKIP_AUTH=true  # 跳过鉴权验证

使用方式

作为 MCP Server 使用

在 Claude Desktop 或其他 MCP 客户端中配置：

{
  "mcpServers": {
    "book-teardown": {
      "command": "npx",
      "args": ["book-teardown-mcp"],
      "env": {
        "GLM5_API_KEY": "your_glm5_api_key",
        "KIMI_API_KEY": "your_kimi_api_key"
      }
    }
  }
}

命令行使用

# 构建项目
npm run build

# 启动 MCP Server
npm start

# 开发模式
npm run dev

MCP Tool 说明

book_teardown

对电子书进行结构化深度拆解。

输入参数：

参数	类型	必填	描述
file_path	string	否*	本地文件路径（PDF、Markdown 或 TXT）
file_content	string	否*	Base64 编码的文件内容
file_url	string	否*	文件的远程 URL
user_intent	string	否	用户的阅读意图
user_role	string	否	用户角色（ceo/manager/student/investor/creator/other）
output_format	string	否	输出格式（full/essentials）
include_mermaid	boolean	否	是否包含 Mermaid 图表

*必须提供 file_path、file_content 或 file_url 之一

示例调用：

{
  "file_path": "/path/to/book.pdf",
  "user_intent": "学习商业策略",
  "user_role": "manager",
  "output_format": "full",
  "include_mermaid": true
}

输出结构

拆解报告包含以下部分：

1. 书籍信息 - 标题、作者、拆解日期
2. 核心矛盾 - 书籍的核心冲突及其解决路径
3. 底层逻辑 - 核心概念、解释和证据
4. 关键洞察 - 分类整理的洞察点
5. 心智模型 - 可复用的思维框架
6. 行动清单 - 优先级排序的执行项
7. 金句摘录 - 可分享的引用
8. 批判性分析 - 局限性、对立观点、作者盲点
9. 可交付物 - Mermaid 图表、行动检查清单

开发

项目结构

src/
├── auth/           # 鉴权模块
├── core/           # 核心业务逻辑
│   ├── classifier.ts      # 识别层
│   ├── teardown.ts        # 主拆解层
│   ├── refiner.ts         # 批判层
│   ├── self-correction.ts # 自我校验
│   ├── fusion.ts          # 融合层
│   └── pipeline.ts        # 流程编排
├── deliverables/   # 可交付物生成
├── llm/            # LLM 客户端
├── operators/      # 算子加载器
├── parsers/        # 文件解析器
├── prompts/        # Prompt 模板
├── tools/          # MCP Tool 定义
└── types/          # 类型定义

运行测试

# 运行所有测试
npm test

# 监听模式
npm run test:watch

构建

npm run build

技术栈

• TypeScript
• Model Context Protocol SDK
• Vitest (测试框架)
• pdf-parse (PDF 解析)
• Axios (HTTP 客户端)

许可证

ISC