EasyRunCraft MCP

EasyRunCraft MCP

EasyRunCraft MCP は、EasyRunCraft 用の Model Context Protocol ブローカーです。アシスタントはこれを使用して、ドキュメント、スプレッドシート、画像、音声、動画、デザインファイルを確認・編集します。処理には EasyRunCraft のネイティブエンジンを使用し、接続されたアカウントの EasyRunCraft クレジットを消費します。

製品	https://easyruncraft.com
セットアップ	https://easyruncraft.com/mcp
料金	https://easyruncraft.com/pricing
レジストリ名	com.easyruncraft/mcp
トランスポート	Streamable HTTP
エンドポイント	https://easyruncraft.com/mcp
認証	OAuth、スコープ mcp:tools（更新には offline_access を使用）

このリポジトリには、ブローカーのエントリーポイント mcp/server.mjs、それがインポートするモジュール、公開 MCP ガイドを収めた docs/、およびレジストリマニフェスト server.json が含まれています。

接続

MCP Streamable HTTP に対応したクライアントにホストされたエンドポイントを追加し、ブラウザーでサインインします。

https://easyruncraft.com/mcp

EasyRunCraft はそのリソースから OAuth メタデータを検出し、アカウントのログイン画面と同意画面を表示して、mcp:tools 用のオーディエンスに紐づいたアクセストークンを発行します。同じエンドポイントでは、https://easyruncraft.com/mcp の詳細設定セクションで作成した専用のベアラートークンも使用できます。

Codex：

codex mcp add easyruncraft --url https://easyruncraft.com/mcp
codex mcp login easyruncraft

このリポジトリの mcp.json は、エージェントプラグインホストで使用するリモートサーバーのエントリーです。上記 URL での Streamable HTTP、OAuth クライアントの識別情報メタデータ、および mcp:tools と offline_access のスコープが設定されています。

ブローカーをローカルで実行する

サポート対象のクライアントエンドポイントはホストされた URL です。このパッケージを使って、同じブローカーをお使いのマシンで起動することもできます。Node.js 22 以降が必要です。アカウントへのサインインとクレジットの請求は、EasyRunCraft アカウント API で引き続き処理されます。ネイティブエディターのバイナリは別個のランタイムリリースであり、MCP_NATIVE_DIR を通じて提供されます。このリポジトリには保存されていません。

npm install
export PUBLIC_URL=http://127.0.0.1:4350
export ACCOUNT_API_URL=http://127.0.0.1:8795
export MCP_BILLING_SECRET="$(openssl rand -hex 32)"
npm start

npm start は node mcp/server.mjs を実行します。開発環境では、プロセスは 127.0.0.1:8796 で待ち受けます。PUBLIC_URL と ACCOUNT_API_URL には、ループバックアドレスを指定する必要があります。/mcp への呼び出しは、ACCOUNT_API_URL が /api/mcp/authenticate でベアラートークンを受け入れた後に処理されます。

変数	開発時のデフォルト値	役割
MCP_PORT	8796	待ち受けポート
LISTEN_HOST	127.0.0.1	待ち受けアドレス
PUBLIC_URL	http://127.0.0.1:4350	OAuth リソースメタデータと署名付きファイル URL に使用する公開オリジン
ACCOUNT_API_URL	http://127.0.0.1:8795	認証と請求に使用するアカウント API
MCP_BILLING_SECRET	未設定	/api/mcp/billing 用の共有シークレット。タスクがクレジットを予約する前に必須（32 文字以上）
MCP_DATA_DIR	.data/dev/mcp-files	非公開のアップロード、出力、ファイルメタデータ
MCP_NATIVE_DIR	.cache/native	インストール済みのネイティブエディター実行ファイル
MCP_WORK_DIR	.cache/mcp-work	ジョブごとの作業ディレクトリ
MCP_CONCURRENCY	2	実行中のジョブ数。1〜4
RUNTIME_STORE_DIR	未設定	リリースエンドポイントが使用するランタイムリリースストア
RUNTIME_RELEASE_SECRET	未設定	ランタイムリリース公開用のベアラーシークレット
NODE_ENV	未設定	production を指定すると、本番環境用の Linux リスナー、HTTPS オリジン、ユーザー ID ごとに分離されたジョブが選択されます

GET /mcp-health は、各ネイティブエンジンが存在するかどうかを報告します。ファイル処理ツールにはこれらのエンジンが必要です。https://easyruncraft.com/mcp のホストサービスには、すでにインストールされています。

ツール

service_info、quote_task、create_upload、inspect_file、edit_spreadsheet、pdf_capabilities、query_pdf、edit_pdf、export_pdf、editor_capabilities、process_photo、process_word、process_deck、process_vector、process_fig、process_cad、process_design、process_light、process_sound、process_film、process_effect、get_job、cancel_job、delete_file。

create_uploadでアップロードし、返されたURLにバイトデータをPUTしてから、形式に対応するツールを呼び出します。quote_taskは、ジョブを送信する前に料金を返します。結果を取得するには、get_jobをポーリングしてください。ファイル処理が正常に完了した場合は、検査、音声変換、動画のエクスポート、アニメーションのレンダリングを含め、1クレジットがかかります。アップロード、見積もり、機能の確認、ステータスのポーリング、ダウンロードに別途料金はかかりません。プランの詳細はhttps://easyruncraft.com/pricingをご覧ください。

一時ファイルは、そのファイルに対する操作がない状態が2時間続くと期限切れになります。処理、見積もり、結果の取得、ダウンロードを行うと、アイドル期限が延長されます。

ディレクトリのメタデータ

MCP Market、TrackMCP、公式MCP Registryは、このリポジトリを直接読み取れます。

• server.jsonとdistribution/server.jsonは、MCP サーバーのスキーマに準拠しています。サーバー名はcom.easyruncraft/mcpです。説明はレジストリの100文字制限内です。remotesには、Streamable HTTPのURLが1つ記載されています：https://easyruncraft.com/mcp。
• package.jsonでは、mcpNameに同じレジストリ名を、homepageにhttps://easyruncraft.comを設定し、gitリポジトリをhttps://github.com/eastling/easyruncraft-mcpとしています。
• mcp.jsonでは、プラグインホスト向けにリモートサーバーを宣言しています。

リポジトリのURL https://github.com/eastling/easyruncraft-mcpをMCP MarketとTrackMCPに送信してください。どちらの掲載先も、この公開リポジトリからREADME、マニフェスト、ソースを取得します。

ドキュメント

• MCPブローカー — ツール、ファイル、料金、実行
• OAuth、CLI、配布
• コマンド一覧
• ネイティブエディター一覧
• PDF一覧

これらのガイドの一部には、EasyRunCraft製品のチェックアウトに含まれるデプロイ用ピンへのリンクがあります。ガイドで説明されているブローカーのソースは、このリポジトリのmcp/ツリーです。

ライセンス

MIT。LICENSEをご覧ください。ネイティブエディターのバイナリはこのパッケージに含まれていません。それぞれのライセンス表記は、各ランタイムのリリースに付属しています。