DocDeploy

DocDeploy

企业级文档智能平台。上传文档、PDF、手册和笔记——DocDeploy 会将其转换为已索引的 Markdown，并通过每个租户专属的 MCP 服务提供访问，以便 AI Agent 查询你的知识库。

工作原理

Upload → Convert to Markdown → Inject Section Markers → Index → Serve via MCP

1. 上传任意文档（PDF、DOCX、PPTX、XLSX、HTML、TXT、CSV、JSON、XML）
2. 转换为简洁、结构化的 Markdown，并保留图片
3. 索引各个章节，添加导航标记并支持全文搜索
4. 通过 MCP 连接 AI Agent——它们可以搜索、浏览和读取你的文档

架构

┌─────────────────────────────────────────┐
│  apps/app        Next.js dashboard      │  ← Vercel
│  apps/web        Marketing site         │  ← Vercel
├─────────────────────────────────────────┤
│  packages/lib         Converter pipeline│
│  packages/db          Drizzle + Neon    │
│  packages/workers     Background jobs   │  ← Render
│  packages/mcp-server  MCP per tenant    │  ← Render
└─────────────────────────────────────────┘

技术栈

层级	技术
前端	Next.js 16、Tailwind CSS、Clerk Auth
数据库	PostgreSQL（Neon）、Drizzle ORM
存储	Cloudflare R2
队列	pg-boss
MCP	@modelcontextprotocol/sdk（Streamable HTTP）
托管	Vercel（前端）、Render（工作进程 + MCP）

MCP 工具

每个租户的 MCP 服务会公开 5 个工具：

工具	描述
get_manifest	完整文档索引——从这里开始
search_documents	搜索所有文档和章节中的全文
get_document	加载带章节标记的完整文档
get_section	按标记加载指定章节
list_documents	列出所有可用文档

文档处理流水线

• PDF — pdf-parse v2，支持结构推断（章节、编号章节、全大写标题）
• DOCX — mammoth，提取图片并保存到 R2
• PPTX — 使用 adm-zip 解析 XML，并提取幻灯片图片
• XLSX — SheetJS，输出多工作表 Markdown 表格
• HTML — Turndown，保留表格并移除导航栏和页脚
• CSV/TSV — SheetJS，可靠处理带引号的字段
• TXT — 为非结构化文本推断结构
• JSON/XML — 使用格式化代码块包裹

Monorepo 结构

docdeploy/
├── apps/
│   ├── app/              # Dashboard (Next.js)
│   └── web/              # Marketing site (Next.js)
├── packages/
│   ├── db/               # Schema + Drizzle config
│   ├── lib/              # Converter, markers, R2, token counter
│   ├── mcp-server/       # MCP server (stdio + HTTP)
│   └── workers/          # Background document processor
├── render.yaml           # Render blueprint
├── turbo.json            # Turborepo config
└── package.json          # Workspace root

开发

# Install dependencies
npm install

# Run the dashboard locally
npm run dev:app

# Run the marketing site
npm run dev:web

环境变量

完整列表请参见 .env.example。必需变量：

• DATABASE_URL — Neon PostgreSQL 连接字符串
• NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY / CLERK_SECRET_KEY — Clerk 身份验证
• R2_ACCOUNT_ID / R2_ACCESS_KEY_ID / R2_SECRET_ACCESS_KEY — Cloudflare R2
• R2_BUCKET_NAME / R2_PUBLIC_URL — R2 存储桶配置
• MCP_API_KEY — 每个租户的 MCP 服务身份验证（仅 Render）

许可证

专有软件 — Copyright (c) 2026 MR Dula Enterprise, LLC. 保留所有权利。

联系方式：[email protected]