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、它导入的模块、docs/ 中的公开 MCP 指南，以及注册表清单 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 是 Agent 插件宿主使用的远程服务条目：它通过上述 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 必须是环回地址。ACCOUNT_API_URL 在 /api/mcp/authenticate 接受承载令牌后，对 /mcp 的调用才会继续处理。

变量	开发环境默认值	作用
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 源和按 UID 隔离的作业

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 上传文件，将字节数据 PUT 到返回的 URL，然后调用与格式匹配的工具。提交任务前，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：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 broker — 工具、文件、计费和执行
• OAuth、CLI 和分发
• 命令清单
• 原生编辑器清单
• PDF 清单

其中一些指南链接到与 EasyRunCraft 产品结账流程一起维护的部署固定版本。这些指南所介绍的 broker 源码位于此代码库的 mcp/ 目录树中。

许可证

MIT。请参阅 LICENSE。原生编辑器二进制文件不属于此软件包；其各自的许可证声明随对应的运行时版本提供。