Document Conversion Assistant

一个基于模型上下文协议 (MCP) 的文档转换服务器，提供强大的文档格式转换功能。

功能特性

• 🔄 支持多种文档格式之间的转换

• 📄 保持文档内容的保真度

• 🔍 自动检测文档格式

• 📚 支持常见的文档类型

• ⚡ 高性能的转换引擎

安装

# 克隆项目
git clone <repository-url>
cd document-conversion-assistant

# 安装依赖
npm install

# 构建项目
npm run build

使用方法

启动 MCP 服务器

node dist/index.js

服务器启动后，将通过标准输入/输出与 MCP 客户端进行通信。

在 Claude Desktop 中使用

1. 在 Claude Desktop 的配置文件中添加此 MCP 服务器

2. 重启 Claude Desktop

3. 现在可以使用文档转换功能

支持的格式

可用工具

convert_document

将文档从一种格式转换为另一种格式。

参数：

• sourceFormat: 源文档格式 (markdown, html, txt, pdf, docx)

• targetFormat: 目标格式 (markdown, html, txt)

• content: 文档内容 (字符串或 Base64 编码)

• filename: 文件名 (可选)

示例：

{
  "sourceFormat": "markdown",
  "targetFormat": "html",
  "content": "# Hello World\n\nThis is a test.",
  "filename": "test.md"
}

detect_document_format

检测给定文档的格式。

参数：

• content: 文档内容

• filename: 文件名 (可选，用于辅助检测)

返回：

• 检测到的文档格式

get_supported_formats

获取所有支持的文档格式列表。

返回：

• 支持的格式数组，包含格式名称和描述

技术架构

核心依赖

• @modelcontextprotocol/sdk: MCP 协议实现

• mammoth: Word 文档处理

• pdf-parse: PDF 文档解析

• marked: Markdown 到 HTML 转换

• jsdom: HTML 处理

• html-to-text: HTML 到文本转换

• zod: 数据验证

项目结构

src/
├── index.ts              # MCP 服务器主入口
├── document-converter.ts  # 文档转换核心逻辑
└── types.d.ts            # TypeScript 类型声明

开发

本地开发

# 安装依赖
npm install

# 开发模式（监听文件变化）
npm run dev

# 构建
npm run build

# 运行
node dist/index.js

测试

项目包含测试文档 test.md，可用于验证转换功能。

贡献

1. Fork 项目

2. 创建功能分支 (git checkout -b feature/amazing-feature)

3. 提交更改 (git commit -m 'Add some amazing feature')

4. 推送到分支 (git push origin feature/amazing-feature)

5. 打开 Pull Request

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

更新日志

v1.0.0

• 初始版本发布

• 支持 Markdown、HTML、TXT、PDF、DOCX 格式

• 实现文档格式自动检测

• 提供完整的 MCP 工具集

常见问题

Q: 如何在 Claude Desktop 中配置？

A: 在 Claude Desktop 的配置文件中添加以下配置：

{
  "mcpServers": {
    "document-converter": {
      "command": "node",
      "args": ["/path/to/document-conversion-assistant/dist/index.js"]
    }
  }
}

Q: 支持哪些 PDF 类型？

A: 目前支持基于文本的 PDF 文件。扫描版 PDF（图像）需要 OCR 处理，暂不支持。

Q: 转换大文件时性能如何？

A: 转换性能取决于文件大小和复杂度。建议单个文件不超过 10MB。