mcpField
F
faktry

faktry

远程服务
faktry.ai媒体与设计13 周前更新

关于 faktry

faktry MCP 将 faktry 的媒体工具提供给兼容 MCP 的客户端,用于生成和编辑图像、视频、音频、PDF 与 3D 资产。它适合通过 AI 客户端处理媒体的用户,提供托管服务、异步任务跟踪和可复用的媒体库。

主要功能

  1. 01生成和编辑图像、视频与音频
  2. 02创建和处理 PDF
  3. 03从文本或图像生成 3D 资产
  4. 04跟踪异步生成任务
  5. 05保存和浏览媒体库资产
  6. 06查看账户积分和用量

适用场景

  1. 01创建并修改产品图像
  2. 02将产品图像制作成带字幕的视频
  3. 03生成旁白或音乐并处理音频
  4. 04创建、合并或提取 PDF 内容

MCP 相关

托管的 MCP 服务提供 70 多个媒体生成与编辑、任务状态、积分和媒体库管理工具。客户端可通过 OAuth 或 API 密钥远程连接,也可使用 stdio 桥接程序。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://faktry.ai/api/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包
npm@faktry/mcp0.1.1

工具

详细介绍

faktry

faktry MCP

将完整的 faktry 媒体工具栈引入你已经在使用的工具。
在任何兼容 MCP 的客户端中生成和编辑图像、视频、音频及 PDF。

许可证:MIT 文档

安装 · 工具 · 示例 · 故障排除

faktry 平台


faktry MCP 服务将完整的 faktry 工具包开放给所有支持模型上下文协议的客户端,包含 70 多种图像、视频、音频、PDF 和 3D 生成及编辑工具。生成产品图,将其剪辑成 UGC 风格视频并配上画外音、添加字幕,再导出缩略图合集,全程无需离开聊天界面。

  • README 配图 **托管式远程服务。**连接到 https://faktry.ai/api/mcp,无需运行本地服务。仅支持 stdio 的客户端可使用 npx -y @faktry/mcp 桥接程序。
  • **OAuth 或 API 密钥,任选其一。**从 Claude.ai、Claude Desktop、Cursor 和 Hermes 一键连接,或在任何基于配置的客户端中填入静态 API 密钥。
  • **默认异步。**长时间运行的任务(视频以及部分图像/音频任务)会立即返回 job_id;轮询 faktry_job_status 直到任务完成。
  • **会记住内容的资料库。**使用 faktry_library_save 保存任意结果,并通过 faktry_library_list 在后续会话中取回。
  • **费用从 faktry 账户扣除。**使用量将从现有余额中扣除,可随时通过 faktry_credits 查看。

安装

一键连接/OAuth

这些客户端会为你处理身份验证——粘贴 URL、登录并批准即可。

MCP 服务 URL:

https://faktry.ai/api/mcp
Claude.ai
  1. 打开 Claude.ai → 设置 → 集成。
  2. 点击 添加 MCP 服务,并粘贴上方的 URL。
  3. Claude.ai 会将你重定向到 faktry;登录并点击 批准。
  4. 完成——Claude.ai 会自动保存令牌。
Claude Desktop
  1. 打开 Claude Desktop → 设置 → 开发者 → MCP 服务。
  2. 点击 添加服务,并粘贴上方的 URL。
  3. 浏览器窗口会打开;登录 faktry 并点击 批准。
  4. 如果工具没有立即显示,请重启 Claude Desktop。
Cursor
  1. 打开 Cursor → 设置 → AI → MCP 服务。
  2. 点击 添加 MCP 服务,并粘贴上方的 URL。
  3. Cursor 会检测到 OAuth,并打开浏览器登录窗口。
  4. 登录 faktry、批准访问权限,然后返回 Cursor。
Hermes Agent
  1. 打开 Hermes Agent → 设置 → MCP 服务。
  2. 点击 + 并粘贴上方的 URL。
  3. Hermes 会打开浏览器登录页面;登录 faktry 并批准。
  4. 启用该服务——工具会立即显示。
ChatGPT Desktop (仅限 Business / Enterprise / Edu)
  1. 在“设置 → Beta 功能”中启用 开发者模式。
  2. 前往 设置 → MCP 服务 → 添加服务。
  3. 粘贴上方的 URL,并按照浏览器中的 OAuth 流程操作。
### 配置文件 / API 密钥

首先在 faktry.ai/api/keys 创建 API 密钥,然后将 faktry 添加到客户端的配置中。将 YOUR_API_KEY_HERE 替换为你的真实密钥——创建时只会显示一次。

Claude Code

添加到 .mcp.json(项目级)或 ~/.claude.json(用户级):

{
  "mcpServers": {
    "faktry": {
      "type": "http",
      "url": "https://faktry.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
    }
  }
}

会自动加载,无需重启。

VS Code (Copilot)

添加到 .vscode/mcp.json(工作区),或通过 设置 → MCP 服务器 添加:

{
  "servers": {
    "faktry": {
      "type": "http",
      "url": "https://faktry.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
    }
  }
}
Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json(Windows 上为 %USERPROFILE%\.codeium\windsurf\mcp_config.json)——请注意,Windsurf 使用 serverUrl,而非 url:

{
  "mcpServers": {
    "faktry": {
      "serverUrl": "https://faktry.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
    }
  }
}

重启 Windsurf 以启用这些工具。

Continue.dev

添加到 ~/.continue/config.yaml:

mcpServers:
  faktry:
    type: http
    url: https://faktry.ai/api/mcp
    requestOptions:
      headers:
        Authorization: "Bearer YOUR_API_KEY_HERE"

Continue.dev 会自动重新加载。

Codex CLI

添加到 ~/.codex/config.toml:

[mcp.servers.faktry]
type = "http"
url = "https://faktry.ai/api/mcp"

[mcp.servers.faktry.headers]
Authorization = "Bearer YOUR_API_KEY_HERE"

使用 codex mcp list 验证。

stdio 客户端(npx) — Zed、较旧的 Claude Desktop 配置,以及任何不支持远程 MCP 的客户端

@faktry/mcp 包是连接托管服务的轻量级 stdio 桥接程序。需要 Node 18+。

通用格式:

FAKTRY_API_KEY=YOUR_API_KEY_HERE npx -y @faktry/mcp

Claude Desktop(claude_desktop_config.json)及大多数其他 mcpServers 客户端:

{
  "mcpServers": {
    "faktry": {
      "command": "npx",
      "args": ["-y", "@faktry/mcp"],
      "env": { "FAKTRY_API_KEY": "YOUR_API_KEY_HERE" }
    }
  }
}

Zed(settings.json,Windows 上为 %APPDATA%\Zed\settings.json):

{
  "context_servers": {
    "faktry": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@faktry/mcp"],
      "env": { "FAKTRY_API_KEY": "YOUR_API_KEY_HERE" }
    }
  }
}

如果要通过浏览器登录(OAuth),请省略 FAKTRY_API_KEY。

Kilo Code
  1. 打开 Kilo Code 扩展设置 → MCP 服务器。
  2. 使用与上方 Claude Code 相同的 JSON 片段添加新服务。
  3. 将 YOUR_API_KEY_HERE 替换为你的真实密钥。
其他 MCP 客户端

添加一个远程 HTTP 服务,指向 https://faktry.ai/api/mcp,并设置以下标头:

Authorization: Bearer YOUR_API_KEY_HERE

也可以在 faktry.ai/mcp 生成针对各客户端的完整配置片段和路径。


工具

客户端会根据你的提示词选择要调用的工具——你无需按名称调用它们。faktry 提供 70 多种工具,分为五个类别:

类别示例功能范围
faktry_image_*generate、edit、inpaint、outpaint、upscale、removebackground、effects、collage、watermark、smartcrop文本生成图像、编辑、放大、移除背景、合成
faktry_video_*text2video、image2video、avatar、motioncontrol、subtitle、reframe、stabilize、upscale、scenedetect生成、编辑、虚拟形象、动作控制、字幕、重新构图
faktry_audio_*generatespeech、clonevoice、generatemusic、generatesound、mix、transcribe、trim语音合成、声音克隆、音乐/音效生成、混音
faktry_pdf_*create、merge、split、compress、extract、mdconvertPDF 创建与处理
faktry_3d_*image23d、text23d根据图像或文本生成 3D 资产

此外还有实用工具:

工具功能
faktry_job_status通过 job_id 轮询异步任务,直到状态变为 completed,并返回 result_url
faktry_credits查看积分余额和当月用量
faktry_library_list浏览之前保存的媒体资产
faktry_library_save将结果 URL 保存到资料库,以便在不同会话中重复使用
异步任务模式

大多数生成工具(视频、部分图像/音频工具)均为异步:

  1. 调用生成工具 → 接收 job_id。
  2. 每隔几秒使用该 job_id 轮询 faktry_job_status。
  3. 状态变为 completed 后,响应中会包含 result_url。
  4. 可选择使用 faktry_library_save 保存结果。

示例提示词

连接 faktry 后,试试这些:

Generate a studio product shot of a matte black wireless speaker on a
white background, then upscale it to 4K.
Turn this product image into a 9:16 UGC-style video with a voiceover
reading the description, and add subtitles.
Remove the background from this photo, then composite it onto a
gradient backdrop.
Clone this voice sample and generate a 30-second narration reading
this script.
Check my faktry credits, then show me what's in my library.

故障排除

连接后未显示工具
  • Claude.ai / Desktop: 设置 → 集成(或 Developer → MCP Servers),确认 faktry 显示为已连接。如果连接悄无声息地失败,请移除后重新添加;确保未屏蔽弹出窗口,以便打开 OAuth 窗口。
  • Claude Code: claude mcp list 应显示该服务。
  • Codex: codex mcp list 应显示 faktry。添加后启动新会话。
  • 快速冒烟测试:向客户端询问 “检查我的 faktry 额度”。
身份验证或 API 密钥错误
  • 对于配置文件客户端,请确认已将 YOUR_API_KEY_HERE 替换为从 faktry.ai/api/keys 获取的有效密钥;密钥仅在创建时显示一次。
  • 对于 OAuth 客户端,请断开连接后重新连接该连接器,以重新完成授权流程。
生成任务一直处于加载状态

视频渲染以及某些音频/图像任务所需时间会比普通图像生成更长。工具会立即返回待处理的 job_id;请持续轮询 faktry_job_status,直到其报告 completed。


链接


许可证

MIT © faktry

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。