项目简介

TweekIT MCP 服务器是一个通用的媒体转换与处理服务，专门为AI工作流设计。它能将400多种文件类型转换为AI可处理的标准化格式，有效解决LLM处理非结构化或不兼容文件格式的痛点。该服务器基于FastMCP框架构建，通过标准JSON-RPC协议提供资源访问和工具调用能力。

主要功能点

广泛的文件支持: 支持超过400种文件类型的摄取和转换，涵盖图片、文档、音视频等。
智能格式转换: 自动将各种输入文件（如PNG、JPG、PDF、DOCX等）转换为AI所需的标准化格式（如图像转WebP/PNG，文档转PDF）。
图像处理: 提供灵活的图像转换功能，包括裁剪、缩放、调整分辨率、背景颜色填充等操作。
远程文件处理: 允许直接通过URL获取并转换远程文件，无需先下载到本地。
信息查询: 提供工具用于查询TweekIT API的版本信息，以及支持的输入文件格式列表。
AI工作流优化: 确保AI代理能够接收更广泛的用户输入，并自动处理媒体资产，减少人工干预，提高工作流的可靠性和效率。

安装步骤

在开始之前，请确保您的系统已安装 Python 3.10 或更高版本。

克隆仓库:

git clone https://github.com/equilibrium-team/tweekit-mcp.git

进入项目目录:
```
cd tweekit-mcp
```

安装依赖:

pip install -r requirements.txt

获取API凭证: 访问 TweekIT 官网注册账户，在管理页面获取您的 API Key 和 API Secret。这些凭证将用于认证您对TweekIT服务的请求。

服务器配置

MCP客户端需要配置以下信息来连接TweekIT MCP服务器。配置通常以JSON格式提供，指明服务器的连接方式和凭证。以下是一个典型的MCP客户端配置示例，您需要根据实际部署情况和客户端类型进行调整：

{
  "mcpServers": {
    "tweekit": {
      "transport": {
        "type": "http", 
        "url": "https://mcp.tweekit.io/mcp/"
      },
      "headers": {
        "ApiKey": "${YOUR_TWEEKIT_API_KEY}",
        "ApiSecret": "${YOUR_TWEEKIT_API_SECRET}"
      }
    }
  }
}

配置参数说明:

'mcpServers': 这是客户端配置MCP服务器的顶级键。
'tweekit': 您可以自定义服务器的名称，此处以'tweekit'为例。
'transport': 定义客户端与MCP服务器通信的传输方式。
- 'type': 传输协议类型。常用的有'http'或'streamable-http'，具体取决于您的MCP客户端所支持的协议。
- 'url': MCP服务器的访问地址。
  - 如果您选择连接TweekIT提供的公共托管服务，URL应设置为 'https://mcp.tweekit.io/mcp/'。
  - 如果您选择在本地运行服务器，URL通常为 'http://localhost:8080/mcp/' (如果您通过 'uv run server.py' 启动，默认端口为8080)。
'headers': 用于MCP服务器的身份验证。
- 'ApiKey': 您的TweekIT API Key。请将其替换为从TweekIT官网获取的实际密钥。
- 'ApiSecret': 您的TweekIT API Secret。请将其替换为从TweekIT官网获取的实际密钥。
- 重要提示: 某些客户端可能通过其他方式（例如环境变量）管理凭证，或者支持'Authorization: Bearer <API_KEY>'头。请根据您使用的MCP客户端文档调整认证方式。

基本使用方法

启动本地MCP服务器 (可选): 如果您想在本地运行TweekIT MCP服务器进行开发或测试，请在项目根目录执行：
```
uv run server.py
```
服务器将在 'http://localhost:8080/mcp/' 监听客户端请求。

通过MCP客户端调用工具: 一旦TweekIT MCP服务器（无论是本地运行还是公共托管）已启动并可通过您配置的URL访问，您的MCP客户端（如Claude Desktop, ChatGPT MCP等）即可连接并调用其提供的工具和资源。

示例: 调用 'convert' 工具进行图片转换 您可以指示AI代理调用 'convert' 工具，将Base64编码的PNG图片转换为WebP格式并进行尺寸调整。客户端将发送类似如下的MCP请求（JSON-RPC格式）：

{
  "method": "tools/call",
  "params": {
    "name": "convert",
    "arguments": {
      "apiKey": "您的TweekIT API Key",
      "apiSecret": "您的TweekIT API Secret",
      "inext": "png",
      "outfmt": "webp",
      "blob": "<Base64编码的图片数据>",
      "width": 300,
      "height": 300
    }
  },
  "jsonrpc": "2.0",
  "id": 4
}

MCP服务器将处理此请求，调用TweekIT的后端服务进行转换，并将转换后的结果（通常是Base64编码的数据）返回给您的客户端。

其他工具调用示例:
- 查询支持的文件类型: 调用 'doctype' 工具并提供 'extension: "*"' 参数以获取所有支持的输入类型列表。
- 转换远程文件: 调用 'convert_url' 工具，提供文件的URL和所需的输出格式，服务器将自动下载并转换文件。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息