foxit-pdf-api-mcp-server

🚀 福昕PDF API MCP服务器

福昕PDF API MCP服务器通过模型上下文协议（MCP），将福昕PDF服务API操作作为工具，提供给Claude Desktop、Cursor等AI智能体以及其他支持MCP的应用程序使用。

🚀 快速开始

前提条件

• API凭证：在福昕开发者门户注册，获取客户端ID和客户端密钥。
• Python版本：Python 3.11及以上版本，以及uv包管理器。
• TypeScript版本：Node.js 18及以上版本，以及pnpm。

快速上手

选择你偏好的实现方式：

Python：

cd python/foxit-pdf-api-mcp-server
# 完整说明请查看 python/foxit-pdf-api-mcp-server/README.md

TypeScript：

cd typescript/foxit-pdf-api-mcp-server
# 完整说明请查看 typescript/foxit-pdf-api-mcp-server/README.md

✨ 主要特性

Python和TypeScript版本均提供以下功能：

• 📄 文档生命周期管理 - 上传、下载、删除文档
• 🔄 PDF创建 - 将Word、Excel、PPT、HTML、URL、文本、图像转换为PDF
• 📤 PDF转换 - 将PDF转换为Word、Excel、PPT、HTML、文本、图像
• ✂️ 文档操作 - 拆分、合并、提取、压缩、扁平化、线性化、添加水印、页面操作
• 🔒 安全设置 - 添加/移除密码，设置权限
• 📊 属性提取 - 提取全面的PDF元数据和属性
• 🔍 文档分析 - 比较PDF文件
• 📝 表单处理 - 以JSON格式导出和导入表单数据

📦 安装指南

环境变量

所有版本都需要设置以下环境变量：

• FOXIT_CLOUD_API_HOST：API主机URL（例如，https://na1.fusion.foxit.com/pdf-services）
• FOXIT_CLOUD_API_CLIENT_ID：你在福昕开发者门户获取的客户端ID
• FOXIT_CLOUD_API_CLIENT_SECRET：你在福昕开发者门户获取的客户端密钥

📚 详细文档

各版本实现说明

本目录包含福昕PDF API MCP服务器的多种实现方式：

🐍 Python版本

• 位置：python/foxit-pdf-api-mcp-server/
• 特性：支持35种以上的PDF操作，包括创建、转换、操作、安全设置、OCR、表单处理和分析等。
• 技术栈：FastMCP、Python 3.11+、uv包管理器
• 状态：✅ 积极开发中 - 与TypeScript版本功能完全一致

👉 查看Python版README 获取安装和使用说明。

📘 TypeScript版本

• 位置：typescript/foxit-pdf-api-mcp-server/
• 特性：支持35种以上的PDF操作，提供全面的TypeScript支持。
• 技术栈：TypeScript、Node.js、pnpm
• 状态：✅ 积极开发中 - 与Python版本功能完全一致

👉 查看TypeScript版README 获取安装和使用说明。

⚠️ stdio-python（旧版）

• 位置：stdio-python/
• 状态：⚠️ 已弃用 - 请使用上述新的Python版本。
• 注意：这是最初的实现方式，不再维护。

📄 支持与帮助

如果你遇到问题或有疑问：

• 查看你所选实现方式的具体README文件。
• 访问福昕开发者门户查看API文档。
• 参考CONTRIBUTING.md指南进行开发环境设置。