文档处理管道

基于Model Context Protocol的文档处理管道,提供从SEC EDGAR Filing下载到Markdown转换的完整工作流程。

  • by dra2sun7
  • HTML
  • 本地部署
  • 更新于
在 GitHub 查看 dra2sun7/mcp-server

使用说明

🧠 MCP服务器

基于Model Context Protocol的文档处理管道
从SEC EDGAR Filing下载到Markdown转换


📌 概述

该项目实现了基于模型上下文协议(MCP)的文档处理管道。
从SEC EDGAR下载公司文件,将HTML转换为PDF,并提供最终转换为Markdown的完整工作流。


🚀 主要功能

📊 下载_归档

  • 通过SEC EDGAR API自动下载公司文件
  • 支持8-K、10-Q、10-K、DEF14A
  • 基于CIK的公司搜索和最新的Filing选择

📄 html_to_pdf

  • 将HTML文件转换为PDF
  • 使用Playwright渲染实际浏览器
  • 批处理支持

📝 read_me_markdown

  • 将PDF转换为Markdown
  • 利用Docling框架
  • 保留文档结构

📂 项目结构

mcp-server/
├── download_sec_filing/     # SEC Filing 다운로드 도구
│   ├── main.py
│   ├── requirements.txt
│   ├── tests/
│   └── README.md
├── html_to_pdf/            # HTML to PDF 변환 도구
│   ├── main.py
│   ├── requirements.txt
│   ├── tests/
│   └── README.md
├── read_me_markdown/       # PDF to Markdown 변환 도구
│   ├── main.py
│   ├── requirements.txt
│   ├── tests/
│   └── README.md
├── requirements.txt        # 메인 프로젝트 의존성
└── README.md              # 이 파일

🔄 工作流

1. download_sec_filing → HTML 파일 다운로드
2. html_to_pdf → HTML을 PDF로 변환  
3. read_me_markdown → PDF를 Markdown으로 변환

🛠️ 安装和设置

1.安装基本依赖性

pip install -r requirements.txt

2.安装Playwright浏览器(用于html_to_pdf)

pip install playwright
playwright install

3.安装每个工具的依赖性

# download_sec_filing
cd download_sec_filing
pip install -r requirements.txt

# html_to_pdf  
cd ../html_to_pdf
pip install -r requirements.txt

# read_me_markdown
cd ../read_me_markdown
pip install -r requirements.txt

🚀 使用示例

1.下载SEC Filing

cd download_sec_filing
python main.py

2.将HTML转换为PDF

cd html_to_pdf
python main.py

3.将PDF转换为Markdown

cd read_me_markdown
python main.py

🧪 测试

每个工具都可以运行测试:

# download_sec_filing 테스트
cd download_sec_filing
pytest tests/

# html_to_pdf 테스트
cd ../html_to_pdf
pytest tests/

# read_me_markdown 테스트
cd ../read_me_markdown
pytest tests/

📚 参考资料


本项目是基于MCP的文档处理管道的完整实施。