Metadata-Version: 2.4
Name: ppt-to-markdown-mcp
Version: 0.1.0
Summary: PPT转Markdown MCP服务器 - Python版本
Requires-Python: >=3.11
Requires-Dist: markitdown[pptx]>=0.0.1a3
Requires-Dist: mcp>=1.0.0
Requires-Dist: python-pptx>=0.6.0
Description-Content-Type: text/markdown

# 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服务器实现
```