faktry

io.github.faktryv0.1.1更新於 Oct 6, 2026

Official faktry MCP server: generate and edit images, video, audio, and PDFs.

已驗證Streamable HTTP可網頁執行AI & MLFiles & StorageMedia & Design

概覽

AI 產生的概覽

為助理提供 70 多個 faktry 工具，用來生成與編輯圖像、影片、音訊、PDF 與 3D 素材，支援非同步任務輪詢與媒體庫保存。

功能
把 faktry 媒體工具組接入 MCP 用戶端：文字生圖、圖像編輯、局部重繪、擴圖、放大、去背與合成；影片生成、虛擬人物、動作控制、字幕與重新取景；語音合成、聲音複製、音樂與音效生成、轉錄與混音；PDF 建立與處理；以及從圖像或文字生成 3D 素材。耗時任務會立即回傳 job_id，需以 faktry_job_status 輪詢直到取得 result_url。輔助工具可查詢額度、瀏覽媒體庫，並保存結果供後續工作階段重用。
適用情境
適合想在聊天用戶端內完成媒體製作的場合：產品圖、含配音與字幕的 UGC 風格影片、聲音複製、PDF 組裝或 3D 素材。也適合已使用 faktry 帳號、且能接受非同步任務輪詢的工作流程。
執行需求
可使用遠端端點 faktry.ai/api/mcp，或以 npx 執行 npm 橋接套件 @faktry/mcp，後者需要 Node 18 以上。驗證方式為瀏覽器 OAuth，或透過 FAKTRY_API_KEY 環境變數、Authorization Bearer 標頭提供 API 金鑰。需要 faktry 帳號與額度，並需能連線該託管服務。
安裝前請注意
使用會依 faktry 帳號額度計費，生成與編輯呼叫都會消耗餘額，可用 faktry_credits 查看。FAKTRY_API_KEY 金鑰僅在建立時顯示一次，應避免寫入共用設定。聲音複製與虛擬人物工具會處理聲音或肖像資料，生成或編輯的媒體會上傳至遠端服務保存，包括存入媒體庫的內容。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 faktry，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "faktry-mcp": {
      "type": "http",
      "url": "https://faktry.ai/api/mcp"
    }
  }
}

README

[faktry]

faktry MCP

Bring the whole faktry media stack into the tools you already use.
Generate and edit images, video, audio, and PDFs from any MCP-compatible client.

[License: MIT] [Docs]

Install · Tools · Examples · Troubleshooting

[faktry platform]

The faktry MCP server exposes the full faktry toolkit — over 70 tools spanning image, video, audio, PDF, and 3D generation and editing — to any client that speaks the Model Context Protocol. Generate a product shot, cut it into a UGC-style video with a voiceover, subtitle it, and export a thumbnail sheet, all without leaving the chat.

  • [圖片] Hosted, remote. Connect to https://faktry.ai/api/mcp — no local server to run. stdio-only clients can use the npx -y @faktry/mcp bridge.
  • OAuth or API key, your choice. One-click connect from Claude.ai, Claude Desktop, Cursor, and Hermes, or drop a static API key into any config-based client.
  • Async by default. Long-running jobs (video, some image/audio) return a job_id immediately; poll faktry_job_status until it's ready.
  • A library that remembers. Save any result with faktry_library_save and pull it back into a later session with faktry_library_list.
  • You pay through your faktry account. Usage draws down your existing credit balance — check it anytime with faktry_credits.

Install

One-click / OAuth

These clients handle authentication for you — paste the URL, sign in, approve.

MCP Server URL:

https://faktry.ai/api/mcp
Claude.ai
  1. Open Claude.ai → Settings → Integrations.
  2. Click Add MCP Server and paste the URL above.
  3. Claude.ai redirects you to faktry — sign in and click Approve.
  4. Done — Claude.ai stores the token automatically.
Claude Desktop
  1. Open Claude Desktop → Settings → Developer → MCP Servers.
  2. Click Add Server and paste the URL above.
  3. A browser window opens — sign in to faktry and click Approve.
  4. Restart Claude Desktop if tools don't appear immediately.
Cursor
  1. Open Cursor → Settings → AI → MCP Servers.
  2. Click Add MCP Server and paste the URL above.
  3. Cursor detects OAuth and opens a browser login window.
  4. Sign in to faktry, approve access, and return to Cursor.
Hermes Agent
  1. Open Hermes Agent → Settings → MCP Servers.
  2. Click + and paste the URL above.
  3. Hermes opens a browser login — sign in to faktry and approve.
  4. Toggle the server on — tools appear immediately.
ChatGPT Desktop (Business / Enterprise / Edu only)
  1. Enable Developer Mode in Settings → Beta Features.
  2. Go to Settings → MCP Servers → Add Server.
  3. Paste the URL above and follow the browser OAuth flow.

Config file / API key

Create an API key at faktry.ai/api/keys first, then add faktry to your client's config. Replace YOUR_API_KEY_HERE with your real key — it's only shown once when created.

Claude Code

Add to .mcp.json (project) or ~/.claude.json (user):

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

Picked up automatically — no restart needed.

VS Code (Copilot)

Add to .vscode/mcp.json (workspace) or via Settings → MCP Servers:

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

Edit ~/.codeium/windsurf/mcp_config.json (%USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows) — note Windsurf uses serverUrl, not url:

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

Restart Windsurf to activate the tools.

Continue.dev

Add to ~/.continue/config.yaml:

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

Continue.dev reloads automatically.

Codex CLI

Add to ~/.codex/config.toml:

toml
[mcp.servers.faktry]type = "http"url = "https://faktry.ai/api/mcp"
[mcp.servers.faktry.headers]Authorization = "Bearer YOUR_API_KEY_HERE"

Verify with codex mcp list.

stdio clients (npx) — Zed, older Claude Desktop configs, and anything without remote MCP

The @faktry/mcp package is a thin stdio bridge to the hosted server. Requires Node 18+.

Generic form:

bash
FAKTRY_API_KEY=YOUR_API_KEY_HERE npx -y @faktry/mcp

Claude Desktop (claude_desktop_config.json) and most other mcpServers clients:

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

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

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

Leave FAKTRY_API_KEY out to sign in through the browser (OAuth) instead.

Kilo Code
  1. Open the Kilo Code extension settings → MCP Servers.
  2. Add a new server using the same JSON snippet as Claude Code above.
  3. Replace YOUR_API_KEY_HERE with your actual key.
Other MCP clients

Add a remote HTTP server pointing at https://faktry.ai/api/mcp with header:

Authorization: Bearer YOUR_API_KEY_HERE

Full per-client snippets and paths are also generated at faktry.ai/mcp.

Tools

Your client picks which tool to call based on your prompt — you don't need to invoke them by name. faktry exposes 70+ tools across five categories:

CategoryExamplesWhat it covers
faktry_image_*generate, edit, inpaint, outpaint, upscale, removebackground, effects, collage, watermark, smartcropText-to-image, editing, upscaling, background removal, compositing
faktry_video_*text2video, image2video, avatar, motioncontrol, subtitle, reframe, stabilize, upscale, scenedetectGeneration, editing, avatars, motion control, subtitles, reframing
faktry_audio_*generatespeech, clonevoice, generatemusic, generatesound, mix, transcribe, trimSpeech synthesis, voice cloning, music/SFX generation, mixing
faktry_pdf_*create, merge, split, compress, extract, mdconvertPDF creation and manipulation
faktry_3d_*image23d, text23d3D asset generation from images or text

Plus utility tools:

ToolWhat it does
faktry_job_statusPoll an async job by job_id until it's completed, returning result_url
faktry_creditsCheck credit balance and current-month usage
faktry_library_listBrowse previously saved media assets
faktry_library_saveSave a result URL to the library for reuse across sessions

The async job pattern

Most generation tools (video, some image/audio) are async:

  1. Call the generation tool → receive a job_id.
  2. Poll faktry_job_status with that job_id every few seconds.
  3. When status is completed, the response contains result_url.
  4. Optionally persist it with faktry_library_save.

Example prompts

Try these once faktry is connected:

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

Troubleshooting

Tools don't appear after connecting
  • Claude.ai / Desktop: Settings → Integrations (or Developer → MCP Servers), confirm faktry shows as connected. Remove and re-add if it failed silently — make sure pop-ups aren't blocked so the OAuth window can open.
  • Claude Code: claude mcp list should show the server.
  • Codex: codex mcp list should show faktry. Start a new session after adding.
  • Quick smoke test: ask your client "check my faktry credits".
Authentication or API key errors
  • For config-file clients, confirm YOUR_API_KEY_HERE was replaced with a real, active key from faktry.ai/api/keys — keys are shown only once at creation.
  • For OAuth clients, disconnect and reconnect the connector to redo the flow.
A generation keeps loading

Video renders and some audio/image jobs take longer than a plain image generation. The tool returns a pending job_id immediately — keep polling faktry_job_status until it reports completed.

Links

License

MIT © faktry

來源：README.md，提交 6411bc2

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.1最新Oct 6, 2026