MCP开发框架
2025.03.12
1
Python文件管理开发效率文件管理开发效率
MCP开发框架是一个强大的Model Context Protocol开发框架，专为创建与大语言模型交互的自定义工具而设计。它提供了一套完整的工具集，能够扩展Cursor IDE的功能，实现网页内容获取、文件处理（PDF、Word、Excel）等高级功能。该框架支持多种文件格式的处理，包括PDF、Word和Excel，并提供了智能文件类型识别、高效的文档处理和内存优化等技术特点。
View on GitHub
Overview
基本能力
产品定位
MCP开发框架是一个用于创建与大语言模型交互的自定义工具的开发框架，特别适合需要处理多种文件格式和网页内容的开发者。
核心功能
- 综合文件处理：自动识别文件类型并选择合适的处理方式，支持PDF、Word和Excel文件。
- PDF文档处理：支持快速预览和完整解析两种模式，提取文本和图片内容。
- Word文档解析：提取文本、表格和图片信息。
- Excel文件处理：解析Excel文件的所有工作表，提供完整的表格数据和结构信息。
- 网页内容获取：获取任何网页的文本内容，具有完整的HTTP错误处理和超时管理。
适用场景
- 需要处理多种文件格式的开发者。
- 需要与大语言模型交互的自定义工具开发。
- 需要高效处理大型文件和数据表格的场景。
工具列表
- file工具：综合文件处理，支持PDF、Word和Excel。
- pdf工具：处理PDF文档，支持快速预览和完整解析。
- word工具：解析Word文档，提取文本、表格和图片信息。
- excel工具：解析Excel文件，提供工作表详细信息。
- url工具：获取网页内容，具有错误处理和超时管理。
常见问题解答
- 如何开发新工具：在
tools目录下创建Python文件，继承BaseTool并实现execute方法。 - 如何处理大型文件：框架支持分块处理和内存优化。
- 错误处理：框架提供详细的错误信息和优雅的失败处理机制。
使用教程
使用依赖
- Ubuntu/Debian：
sudo apt-get update
sudo apt-get install -y poppler-utils tesseract-ocr tesseract-ocr-chi-sim
- macOS：
brew install poppler tesseract tesseract-lang
- Windows：下载并安装Tesseract，添加到系统PATH。
安装教程
- Docker部署：
git clone https://github.com/your-username/mcp-framework.git
cd mcp-framework
cp .env.example .env
docker compose up --build -d
- 传统Python部署：
python -m venv venv
source venv/bin/activate # Linux/Mac
.\venv\Scripts\activate # Windows
pip install -r requirements.txt
python -m mcp_tool
调试方式
- 查看日志：
docker compose logs -f
- 访问服务：SSE端点: http://localhost:8000/sse
- Cursor IDE配置：添加MCP服务器，类型: "sse"，URL:
http://localhost:8000/sse。