MCP开发框架

基本能力

产品定位

MCP开发框架是一个用于创建与大语言模型交互的自定义工具的开发框架，特别适合需要处理多种文件类型和进行AI对话的场景。

核心功能

1. 综合文件处理：支持PDF、Word、Excel、CSV和Markdown文件的自动识别和处理。
2. PDF文档处理：支持快速预览和完整解析两种模式。
3. Word文档解析：提取文本、表格和图片信息。
4. Excel文件处理：解析Excel文件的所有工作表，提供完整的表格数据和结构信息。
5. CSV文件处理：提供完整的数据分析和预览功能。
6. Markdown文件解析：提取文本内容、标题结构和列表等信息。
7. 网页内容获取：获取任何网页的文本内容。
8. MaxKB AI对话：与MaxKB API进行交互，实现智能对话功能。

适用场景

1. 需要处理多种文件类型的开发场景。
2. 需要与AI进行交互的智能对话场景。
3. 需要获取网页内容的自动化任务。

工具列表

1. parse_file：综合文件处理工具，支持多种文件类型。
2. parse_pdf：PDF文档处理工具，支持快速预览和完整解析。
3. parse_word：Word文档解析工具，提取文本、表格和图片信息。
4. parse_excel：Excel文件处理工具，解析所有工作表。
5. parse_csv：CSV文件处理工具，提供数据分析和预览。
6. parse_markdown：Markdown文件解析工具，提取标题结构和内容元素。
7. url：网页内容获取工具。
8. maxkb：MaxKB AI对话工具。

常见问题解答

1. 如何开发新工具：在tools目录下创建新的Python文件，继承BaseTool类并实现execute方法。
2. 如何部署：支持Docker部署和传统Python部署。
3. 如何配置环境变量：在.env文件中配置服务器端口、MaxKB API主机地址等。

使用教程

使用依赖

1. Ubuntu/Debian：

sudo apt-get update
sudo apt-get install -y poppler-utils tesseract-ocr tesseract-ocr-chi-sim

1. macOS：

brew install poppler tesseract tesseract-lang

1. Windows：下载并安装Tesseract，并将其添加到系统PATH。

安装教程

1. Docker部署：

git clone https://github.com/your-username/mcp-framework.git
cd mcp-framework
cp .env.example .env
docker compose up --build -d

1. 传统Python部署：

python -m venv venv
source venv/bin/activate  # Linux/Mac
.\venv\Scripts\activate  # Windows
pip install -r requirements.txt
python -m mcp_tool

调试方式

1. 查看日志：

docker compose logs -f

1. 访问服务：
2. SSE端点: http://localhost:8000/sse
3. Cursor IDE配置：
4. 类型: "sse"
5. URL: http://localhost:8000/sse

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。