Convertapi MCP

ConvertAPI MCP服务器

我们的托管MCP服务器可在https://mcp.convertapi.io-在 下面托管MCP部分.

A. 模型上下文协议（MCP） 服务器，通过以下方式为AI助手提供强大的文件格式转换功能 转换API 服务。通过OpenAPI驱动的参数验证，在200多种文件格式之间转换文档、图像、电子表格、演示文稿等。

特性

• 🔄 通用文件转换 -转换200多种文件格式（PDF、DOCX、XLSX、JPG、PNG、HTML等）
• ✅ OpenAPI驱动验证 -根据ConvertAPI的实时OpenAPI规范进行动态参数验证
• 🎯 综合参数 -支持所有ConvertAPI参数，包括PageSize、PageOrientation、Quality、StoreFile等。
• 🤖 AI就绪 -与Claude Desktop、Cline和其他兼容MCP的AI助手无缝集成
• 📦 本地 -支持本地文件操作

安装

先决条件

• .NET 9.0 SDK或更高版本
• ConvertAPI帐户和API令牌(免费获得一个)

配置

1. 克隆存储库：

克隆https://github.com/ConvertAPI/convertapi-mcpcd转换API MCP

1. 将ConvertAPI API令牌设置为环境变量：

Windows（PowerShell）： $env:CONVERTAPI_TOKEN=“your_api_TOKEN_here” $env:转换基本URI=“https://v2.convertapi.com"

Linux/macOS： 导出CONVERTAPI_TOKEN=“your_api_TOKEN_here” 导出转换TAPI基本URI=“https://v2.convertapi.com"

1. 构建项目：

.net构建

用法

配置：

在应用程序配置中设置以下内容：

本地模式（带文件下载）： .net运行--项目“CA.MCP.Local”

与AI助手集成

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "convertapi": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "C:\\Path\\To\\CA.MCP.Local\\CA.MCP.Local.csproj",
        "--no-build"
      ],
      "env": {
        "CONVERTAPI_TOKEN": "your_api_token_here",
        "CONVERTAPI_BASE_URI": "https://v2.convertapi.com"
      }
    }
  }
}

Cline（VSCode扩展）

在Cline中添加MCP设置：

{
  "convertapi": {
    "command": "dotnet",
    "args": [
      "run",
      "--project",
      "/path/to/CA.MCP.Local",
      "--no-build"
    ],
    "env": {
      "CONVERTAPI_TOKEN": "your_api_token_here",
      "CONVERTAPI_BASE_URI": "https://v2.convertapi.com"
    }
  }
}

更喜欢托管MCP？（无需设置）

如果你不想安装。NET或运行自己的服务器，您可以使用 托管ConvertAPI MCP 相反。

托管端点：

https://mcp.convertapi.io

只需将MCP客户端配置为使用托管端点并提供ConvertAPI API令牌。

示例（克劳德桌面）

{
  "mcpServers": {
    "convertapi": {
      "url": "https://mcp.convertapi.io",
      "env": {
        "CONVERTAPI_TOKEN": "your_api_token_here"
      }
    }
  }
}

就是这样。您的AI代理可以使用结构化MCP工具调用立即开始转换200多种格式的文档。

如果您需要完全控制、专用网络或自定义部署，请继续进行自托管设置。

可用工具

Convert

通过OpenAPI驱动的参数验证在格式之间动态转换文件。

参数：

• fromFormat （必填）-源格式（例如，“docx”、“xlsx”和“jpg”）
• toFormat （必填）-目标格式（例如“pdf”、“png”、“html”）
• parameters （可选）-将参数转换为键值对
• fileParameters （可选）-使用参数名称转换的文件
• outputDirectory （可选）-保存转换文件的目录（仅限本地模式）

AI助手中的示例用法：

将此Word文档转换为PDF： •发件人：docx •收件人：pdf •文件：C:\\Documents\\report.docx •参数：页面大小=A4，页面方向=纵向

Information

提供有关ConvertAPI功能、支持的格式和使用指南的信息。

支持的转换

ConvertAPI支持跨多个类别的200多种文件格式：

• 文件：PDF、DOCX、DOC、RTF、TXT、ODT、PAGES
• 电子表格：XLSX、XLS、CSV、ODS、数字
• 演示：PPTX、PPT、ODP、密钥
• 图像：JPG、PNG、GIF、BMP、TIFF、SVG、WEBP、ICO
• 网络：HTML、MHTML、MHT
• 电子书：EPUB、MOBI、AZW3
• 档案：ZIP、RAR、7Z
• 还有更多。..

常用转换参数

根据转换类型，您可以使用以下参数：

• PDF选项: PageSize, PageOrientation, MarginTop, MarginBottom, MarginLeft, MarginRight
• 图像选项: Quality, ImageWidth, ImageHeight, ScaleImage, ScaleProportions
• 将军: StoreFile, FileName, Timeout

在转换之前，服务器会根据ConvertAPI的OpenAPI规范自动验证参数。

Claude代码插件

除了自托管的MCP服务器外，该存储库还提供了一个Claude Code插件，通过MCP将Claude连接到ConvertAPI。

它能够实现什么

• 直接从Claude转换不同格式的文件
• 自动化文档和图像处理、外激励和转换

示例用法

• “将此PDF转换为DOCX”
• “合并这些PDF文件并应用\[草稿\]水印”
• “编辑此PDF中的敏感财务信息”
• “使用bleed和cropmarks使此PDF打印就绪”

设置

• 在Claude Code中安装插件
• 通过OAuth进行身份验证

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

资源

• ConvertAPI文档
• 模型上下文协议规范
• ConvertAPI。NET SDK

致谢

• 与 模型上下文协议。网 图书馆
• 由...驱动 转换API

支持

对于问题和疑问：

• ConvertAPI支持： support@convertapi.com
• GitHub问题： 报告问题