semvec/pypi-packages huggingface dataset:
word-to-markdown-mcp 0.1.0
Word转Markdown MCP服务器 - Python版本
Requires Python: >=3.11

# Word转Markdown MCP服务器

这是一个基于Python的MCP (Model Context Protocol) 服务器，用于将Microsoft Word文件转换为Markdown格式。

## 功能特性

- 🚀 直接使用Python的`markitdown`库，支持Word文档处理
- 📄 支持Word格式 (.docx, .doc)
- 📝 保持文档结构和层次
- 🎨 支持格式转换（粗体、斜体、标题等）
- 📊 支持表格转换
- 🖼️ 支持图片信息提取
- 📋 支持列表结构
- 🔧 简单的API接口
- 🛡️ 完整的错误处理

## 安装和使用

### 1. 安装依赖

```bash
cd /Users/fengjinchao/Desktop/mcp/skills/python/word-to-markdown
uv sync
```

### 2. Claude配置

在Claude的MCP配置中添加：

```json
{
  "word-to-markdown-python": {
    "name": "Word转markdown(Python)",
    "type": "stdio",
    "description": "Word转markdown工具，支持文档结构和格式",
    "isActive": true,
    "command": "uv",
    "args": ["--directory", "/Users/fengjinchao/Desktop/mcp/skills/python/word-to-markdown", "run", "word-to-markdown-mcp"]
  }
}
```

### 3. 使用工具

#### 基本用法
```json
{
  "name": "docx-to-markdown",
  "arguments": {
    "filepath": "/path/to/your/document.docx"
  }
}
```

#### 自定义选项
```json
{
  "name": "docx-to-markdown", 
  "arguments": {
    "filepath": "/path/to/your/document.docx",
    "preserve_format": true,
    "extract_images": true
  }
}
```

## 支持的文件格式

- `.docx` - Word 2007+ 格式
- `.doc` - Word 97-2003 格式（通过markitdown支持）

## 转换特性

- ✅ **文档结构**: 保持标题层次和段落结构
- ✅ **文本格式**: 转换粗体、斜体、下划线等格式
- ✅ **标题**: 转换为对应级别的Markdown标题
- ✅ **列表**: 保持有序和无序列表结构
- ✅ **表格**: 转换为Markdown表格格式
- ✅ **图片**: 提取图片信息和描述
- ✅ **链接**: 保持超链接功能
- ✅ **引用**: 转换引用和脚注

## Python版本优势

1. **更好的Word文档支持**: Python在处理Office文档方面有成熟的库
2. **更精确的格式转换**: 直接处理文档对象模型
3. **更好的中文支持**: Python对Unicode和中文处理更完善
4. **更强的自定义能力**: 可以根据需要调整转换逻辑
5. **更好的性能**: 避免子进程调用开销
6. **更好的错误处理**: Python异常处理更完善

## 使用场景

- 📚 **文档迁移**: 将Word文档迁移到Markdown格式
- 📖 **内容发布**: 将Word文档发布到支持Markdown的平台
- 📝 **文档处理**: 批量处理Word文档内容
- 🔄 **格式转换**: 在不同文档格式间转换
- 📋 **内容提取**: 从Word文档中提取纯文本内容

## 代码结构

```
word-to-markdown/
├── pyproject.toml               # 项目配置
├── README.md                   # 说明文档
└── word_to_markdown_mcp/       # 主要代码
    ├── __init__.py            # 包初始化
    └── server.py              # MCP服务器实现
```
ppt-to-markdown-mcp 0.1.0
PPT转Markdown MCP服务器 - Python版本
Requires Python: >=3.11

# PPT转Markdown MCP服务器

这是一个基于Python的MCP (Model Context Protocol) 服务器，用于将PowerPoint文件转换为Markdown格式。

## 功能特性

- 🚀 直接使用Python的`markitdown`库，支持PowerPoint处理
- 📊 支持PowerPoint格式 (.pptx, .ppt)
- 🎯 支持幻灯片结构转换
- 📝 提取文本、图片描述、表格等内容
- 🔧 简单的API接口
- 🛡️ 完整的错误处理

## 安装和使用

### 1. 安装依赖

```bash
cd /Users/fengjinchao/Desktop/mcp/skills/python/ppt-to-markdown
uv sync
```

### 2. Claude配置

在Claude的MCP配置中添加：

```json
{
  "ppt-to-markdown-python": {
    "name": "PPT转markdown(Python)",
    "type": "stdio",
    "description": "Python版本的PPT转markdown工具，支持幻灯片结构",
    "isActive": true,
    "command": "uv",
    "args": ["--directory", "/Users/fengjinchao/Desktop/mcp/skills/python/ppt-to-markdown", "run", "ppt-to-markdown-mcp"]
  }
}
```

### 3. 使用工具

#### 基本用法
```json
{
  "name": "pptx-to-markdown",
  "arguments": {
    "filepath": "/path/to/your/presentation.pptx"
  }
}
```

#### 自定义选项
```json
{
  "name": "pptx-to-markdown", 
  "arguments": {
    "filepath": "/path/to/your/presentation.pptx",
    "include_slides": true
  }
}
```

## 支持的文件格式

- `.pptx` - PowerPoint 2007+ 格式
- `.ppt` - PowerPoint 97-2003 格式（通过markitdown支持）

## 转换特性

- ✅ **幻灯片结构**: 保持幻灯片的逻辑结构
- ✅ **文本内容**: 提取所有文本内容包括标题和正文
- ✅ **图片处理**: 提取图片描述和alt文本
- ✅ **表格支持**: 转换表格为Markdown表格格式
- ✅ **列表处理**: 保持项目符号和编号列表
- ✅ **格式保持**: 尽可能保持原有格式结构

## Python版本优势

1. **更好的Office文档支持**: Python在处理Office文档方面有丰富的库
2. **更直接的处理**: 无需子进程调用，直接API处理
3. **更好的错误处理**: Python异常处理更完善
4. **更强的扩展性**: 易于添加自定义处理逻辑
5. **更好的性能**: 避免进程间通信开销

## 代码结构

```
ppt-to-markdown/
├── pyproject.toml               # 项目配置
├── README.md                   # 说明文档
└── ppt_to_markdown_mcp/        # 主要代码
    ├── __init__.py            # 包初始化
    └── server.py              # MCP服务器实现
```
pdf-to-markdown-mcp 0.1.0
PDF转Markdown MCP服务器 - Python版本
Requires Python: >=3.11

# PDF转Markdown MCP服务器

这是一个基于Python的MCP (Model Context Protocol) 服务器，用于将PDF文件转换为Markdown格式。

## 功能特性

- 🚀 直接使用Python的`markitdown`库，性能更高
- 🔧 简单的API接口
- 📄 支持各种PDF格式
- 🛡️ 完整的错误处理

## 安装和使用

### 1. 安装依赖

```bash
cd /Users/fengjinchao/Desktop/mcp/skills/python/pdf-to-markdown
uv sync
```

### 2. Claude配置

在Claude的MCP配置中添加：

```json
{
  "pdf-to-markdown-python": {
    "name": "PDF转markdown(Python)",
    "type": "stdio",
    "description": "Python版本的PDF转markdown工具，性能更好",
    "isActive": true,
    "command": "uv",
    "args": ["--directory", "/Users/fengjinchao/Desktop/mcp/skills/python/pdf-to-markdown", "run", "pdf-to-markdown-mcp"]
  }
}
```

### 3. 使用工具

```json
{
  "name": "pdf-to-markdown",
  "arguments": {
    "filepath": "/path/to/your/document.pdf"
  }
}
```

## Python版本的优势

1. **更简单的实现**: 直接调用`markitdown.convert()`, 不需要子进程
2. **更好的性能**: 避免了进程间通信的开销
3. **更好的错误处理**: Python的异常处理更直观
4. **更少的依赖**: 不需要TypeScript构建工具链

## 代码结构

```
pdf-to-markdown/
├── pyproject.toml          # 项目配置
├── README.md              # 说明文档
└── pdf_to_markdown_mcp/   # 主要代码
    ├── __init__.py        # 包初始化
    └── server.py          # MCP服务器实现
```