福昕pdf api mcp服务器

Name: 福昕pdf api mcp服务器
Author: foxitsoftware

作者：foxitsoftware8 星标更新：2025-07-16

安装使用来源：spider==github.com

项目介绍

Foxit Cloud API MCP Server

这是一个模型上下文协议（MCP）服务器，通过在 Visual Studio Code 中集成 GitHub Copilot，将 Foxit Cloud API 的 PDF 操作工具直接整合到您的开发流程中。

🚀 功能

Foxit Cloud API MCP Server 提供以下 PDF 操作工具：

convert_pdf_to_file: 将 PDF 文件转换为文本、图像、Word、Excel、HTML 或 PowerPoint 格式。
convert_file_to_pdf: 将文件（例如 docx、pptx、xlsx、txt、图像）转换为 PDF 格式。
convert_url_to_pdf: 将网页从 URL 转换为 PDF 文件。
combine_pdfs: 合并多个 PDF 文件为一个 PDF 文档。
compare_pdfs: 比较两个 PDF 文件，并生成报告或可视差异文档。
compress_pdf: 压缩 PDF 文件以减少其大小，具有可调压缩级别。
extract_pdf: 从 PDF 文件中提取文本、图像。
flatten_pdf: 移除交互元素（如表单、注释），创建静态 PDF。
linearize_pdf: 优化 PDF 文件以实现快速网络浏览，支持渐进加载。
remove_pdf_password: 使用所有者密码移除 PDF 文件的密码保护。
protect_pdf: 使用用户和所有者密码对 PDF 文件添加密码加密。
split_pdf: 根据每页数量将 PDF 文件拆分为多个文件。
manipulate_pdf: 执行页面操作，如移动、删除、添加或旋转页面。

📋 先决条件

开始之前，请确保您已具备以下条件：

安装了 Python 3.10 或更高版本 并将其添加到 PATH 中
安装了 Visual Studio Code 和支持代理模式及模型上下文协议（MCP）能力的 GitHub Copilot 扩展。
pip 包管理器（推荐最新版本）
Foxit Cloud API 凭证（客户端ID和客户端密钥）

🔧 安装

第一步：获取您的 API 凭证

访问 Foxit Cloud API 门户
注册免费账户
获取您的 客户端ID 和 客户端密钥
API 的官方主机 URL 是 https://na1.fusion.foxit.com/pdf-services/api

第二步：构建和安装包

克隆此仓库并导航到项目目录：

git clone <repository-url>
cd foxit-pdf-api-mcp-server/stdio-python

确保已安装 setuptools：

pip install setuptools wheel

然后通过以下命令构建包：

python setup.py sdist bdist_wheel

安装包：
```
pip install ./dist/foxit_pdf_cloudapi-1.0.0-py3-none-any.whl
```
注意：请用实际构建时生成的版本号替换版本号。

第三步：配置 VS Code

打开 VS Code 并访问命令面板：
- Windows/Linux: Ctrl+Shift+P
- macOS: Cmd+Shift+P
输入 MCP 并选择 "MCP: 添加服务器..."
选择 "命令 (stdio)" 作为服务器类型

输入以下命令和参数：

foxit-cloudapi-mcp-service --host https://na1.fusion.foxit.com/pdf-services/api --client_id ${input:client-id} --client_secret ${input:client-secret}

选择您的配置范围：
- 用户设置：适用于所有 VS Code 项目的全局配置
- 工作区设置：特定于项目的配置

注意：有关 MCP 服务器配置的更多详情，请参阅 VS Code 设置文档。

当提示时，输入您的 Foxit Cloud API 凭证。配置将保存为：

{
    "version": "1.0",
    "name": "Foxit Cloud API MCP Server",
    "description": "用于 Foxit Cloud API PDF 操作工具的 MCP 服务器",
    "type": "stdio",
    "command": "foxit-cloudapi-mcp-service",
    "args": [
        "--host",
        "https://na1.fusion.foxit.com/pdf-services/api",
        "--client_id",
        "${input:client-id}",
        "--client_secret",
        "${input:client-id}"
    ]
}

注意：需要手动替换两个占位符（${input:client-id} 和 ${input:client-id}）为您的实际凭证。

🎯 使用

启动服务器

使用 VS Code 界面：
- 打开您配置的 MCP 服务器所在的 mcp.json 或 settings.json 文件
- 点击出现在服务器配置上方的启动按钮
- 当提示时输入您的凭证（安全存储以备将来使用）
验证服务器状态：
- 打开 GitHub Copilot 聊天（Ctrl+Alt+I / Cmd+Ctrl+I）
- 在聊天视图中切换到 代理模式
- 点击工具按钮查看可用的 MCP 服务器
- 确认 "Foxit Cloud API MCP Server" 列出且正在运行

发送您的第一个请求

一旦服务器运行，您可以通过 GitHub Copilot 聊天中的自然语言与 PDF 工具进行交互：

@copilot /agent 将此 PDF 转换为 Word 格式
@copilot /agent 合并 foo.pdf 和 goo.pdf 并命名为 something.pdf
@copilot /agent 压缩上传的 PDF
@copilot /agent 合并这些 PDF 文件

🔍 故障排除

常见问题

服务器无法启动：检查 VS Code 输出面板中的 "MCP 服务器日志"
身份验证错误：确认您的客户端ID和客户端密钥正确无误
端口冲突：确保没有其他服务占用所需端口
缺少依赖项：重新安装包并检查 Python 版本

📄 许可证

本项目采用 MIT 许可证。

⚠️ 安全通知

仅从可信来源安装 MCP 服务器。始终审查配置后再运行，以防未经授权的代码执行。

由 Foxit 开发团队精心制作