# Book Teardown MCP Server

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

## 功能特性

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

## 安装

```bash
npm install book-teardown-mcp
```

## 配置

### 环境变量

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

```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 客户端中配置：

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

### 命令行使用

```bash
# 构建项目
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 之一

**示例调用：**

```json
{
  "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/          # 类型定义
```

### 运行测试

```bash
# 运行所有测试
npm test

# 监听模式
npm run test:watch
```

### 构建

```bash
npm run build
```

## 技术栈

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

## 许可证

ISC