에이전트 강화
게시자의 자체 명령입니다. PlugMCP 엔드포인트가 아닙니다.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code에는 로컬 명령용 설치 링크가 없습니다. 아래 명령을 복사해 터미널에서 실행합니다.
claude mcp add makefx -- npx -y makefx@2.4.0터미널에서 실행합니다.
{ "mcpServers": { "makefx": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
The open-source command-line client for makefx.app.
makefx.app is a pay-per-asset workshop where you and your agent make images, video, and audio on one shared canvas. This CLI calls the same hosted MCP tools an agent uses, plus a few person-only REST commands, for terminal automation, local file transfer, and scripts that need structured JSON.
Make images, video, and audio on makefx.app from your terminal or coding agent.
Node.js 22.18 or newer is required.
npm install -g makefx
makefx login
Login always prints the authorization URL and callback address
(http://127.0.0.1:8765/callback), then tries to open a browser. If the CLI is
running on a remote host, keep login running and open a separate terminal on
the computer with your browser. Start the printed SSH tunnel before opening
the authorization URL:
ssh -N -L 8765:127.0.0.1:8765 user@remote-host
The CLI suggests the detected hostname; replace it with your usual SSH destination or alias if needed. Keep the tunnel open until login finishes.
Use --env production|stage|local to keep separate credentials and select the
endpoint. Production is the default. makefx logout revokes the grant when the
service is reachable and always removes the stored credentials; a grant can
also be revoked from your makefx.app profile. Every help command works without
signing in.
login Sign in through the browser
logout Revoke and remove stored credentials
mcp Relay stdio JSON-RPC to the hosted MCP endpoint
account Show balance and active holds
purchase create|get Prepare or read a credit purchase
profile get|update Read or change the signed-in profile
health Check service reachability and environment
spaces List available spaces
space create|get|update|delete
Create, read, rename, or soft-delete a space
space publish|unpublish Change public visibility as an account owner
(a space the home page is built from cannot be
made private)
voices sync Refresh an account's ElevenLabs voices
voices list List the voices speech accepts for the payer
models List the model catalog for the payer
estimate Quote creation or replay before spending credits
create Create assets or replay an immutable recipe
upload Upload a local image, video, audio, or 3d file
download Download ready media to a new local file
asset get|update|delete Read, change, or soft-delete an asset
describe Describe reusable visual traits
audio align Align or re-align ready audio
audio timings Read or save canonical word timings
link | unlink Manage links between assets
export Write a space document to stdout or a new file
open Print and optionally open a space or asset URL
Run makefx --help for the complete command list. Use
makefx help <command>, makefx space help, makefx asset help,
makefx audio help, or makefx voices help for exact arguments.
Read the current model id and parameter schema before creating. Quote a request before spending credits, and reuse its request id when recovering an uncertain result.
makefx models --kind image --json
makefx estimate --kind image --model MODEL --prompt "A painted market" --json
makefx create --space ACCOUNT/SPACE --kind image \
--model MODEL --prompt "A painted market" --request-id market-01 --wait --json
models accepts --family provider|internal|browser and --model MODEL as
well as --kind; --model prints one entry.
Speech takes a voice_id from the paying account's voices, which the catalog
does not repeat: voices list --space ACCOUNT/SPACE [--query TEXT] prints one
page and the --cursor for the next, and --all reads every page.
create accepts repeated --ref ASSET:SLOT and --param NAME=VALUE options.
References keep their left-to-right command-line order as MCP order 0, 1, and
so on. It also accepts --seed INTEGER, --position '{"x":0,"y":0}',
--tags '["tag"]', and --note TEXT.
Every setting a model's schema declares is a --param. For example, a
connector clip that must move only as its prompt says turns off the provider's
prompt rewrite with --param prompt_expansion=off.
It reads the live catalog for the paying Space before each creation, applies
that catalog's defaults, and refuses invalid model settings or an unavailable
current model without calling create_asset. Exact replay leaves availability
to the recorded route. Use --from-asset with --recipe-mode current|exact to
replay a recipe.
Without --position, the canvas lays a new card out by its lineage; with one,
the card is pinned there. makefx asset update --space S --asset A --position '{"x":0,"y":0}' pins an existing card, and --position null unpins it so the
layout places it again.
Prepare a purchase quote without sending card data or payment tokens. The
optional billing identity is one JSON object, inline or loaded from a file by
prefixing its path with @:
makefx purchase create --account ACCOUNT --product eur20 \
--request-id topup-01 --billing @./billing.json --json
makefx purchase get --purchase PURCHASE --json
makefx profile get --json
makefx profile update --name "Ada Example" --json
makefx health --json
Every public MCP tool has one dedicated shell command recorded in the CLI
dispatcher mapping, unless a product-approved exception is documented there.
makefx mcp is only the generic stdio bridge. Convenience commands such as
download and open may compose a mapped read tool but do not replace its
dedicated command.
upload and download stream media directly through signed URLs; media bytes
do not pass through MCP. Output commands never replace an existing destination.
makefx upload --space ACCOUNT/SPACE --kind image --file ./reference.png
makefx download ASSET --space ACCOUNT/SPACE --out ./result.png
makefx export --space ACCOUNT/SPACE --out ./space.json
MAKEFX_NO_OPEN=1 makefx open ACCOUNT/SPACE
Add --json when a script needs the tool's unchanged structured result. Exit
codes are 0 for success, 1 for tool, network, or file errors, and 2 for invalid
command usage.
Full documentation: makefx.app/docs/cli
This repository is a thin client for the public makefx.app API and MCP endpoint. Every command maps to a public MCP tool or a documented REST route that a signed-in person may call. It contains no service code, provider credentials, model prompts, database access, raw API passthrough, or administrative controls.
The makefx.app service, canvas, and generation pipeline remain closed source. See TRADEMARKS.md for the distinction between the Apache-licensed code and the makefx name.
Production is the default. --env stage and --env local are intended for
makefx.app development. Credentials are stored per environment in
$XDG_CONFIG_HOME/makefx-cli/config.json (by default under ~/.config),
readable only by your user; the CLI never writes them into a project directory.
npm install
npm run check
node dist/makefx.js --help
npm run check type-checks and tests the client, builds the executable,
verifies the public client boundary, and installs the packed npm tarball in a
clean directory to exercise help, sign-in hints, and an authenticated tool call
against a local mock server.
Contributions are welcome for the public client. Read CONTRIBUTING.md and SECURITY.md before opening a pull request or reporting a vulnerability.
Create a textured GLB from an image already in a Space:
makefx models --kind 3d
makefx estimate --space ACCOUNT/SPACE --kind 3d --model 3d/hi3d-3 --ref IMAGE_ASSET:reference
makefx create --space ACCOUNT/SPACE --kind 3d --model 3d/hi3d-3 --ref IMAGE_ASSET:reference --param resolution=2048quality --wait
makefx upload --space ACCOUNT/SPACE --kind 3d --file model.glb
Create geometry only, add a second view, or texture an existing GLB:
makefx create --space ACCOUNT/SPACE --kind 3d --model 3d/hi3d-3 --ref FRONT_IMAGE:reference --ref LEFT_IMAGE:left_view --param output_mode=geometry --wait
makefx estimate --space ACCOUNT/SPACE --kind 3d --model 3d/hi3d-3-texture --ref MODEL_ASSET:source --ref FRONT_IMAGE:reference
makefx create --space ACCOUNT/SPACE --kind 3d --model 3d/hi3d-3-texture --ref MODEL_ASSET:source --ref FRONT_IMAGE:reference --wait
reference is the front image; back_view, left_view, and right_view are
optional images of the same object. output_mode=textured is the default.
Texturing requires a source GLB and creates a new asset with PBR textures on
that geometry. It does not edit the shape or provide free retries.
Hi3D uses an image reference instead of a prompt. Read the live catalog for
settings and use the service quote before generating. GLB uploads infer
model/gltf-binary; ordinary asset downloads and exports preserve the GLB file.
Apache License 2.0. See LICENSE, NOTICE, and THIRD_PARTY_NOTICES.md.
Make images, video, and audio on makefx.app from your terminal or coding agent.
{ "mcpServers": { "makefx": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Makefx은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-10-28. Make images, video, and audio on makefx.app from your terminal or coding agent.