Easy2257

easy2257-mcp：Easy2257 MCP 连接器

此仓库是 Easy2257 Model Context Protocol 服务的公开目录。服务本身由 Easy2257 托管，并通过网络访问，因此无需在此安装任何内容，也不包含引擎源代码：此仓库仅包含注册表元数据、隐私声明和设置说明。

端点： https://easy2257.com/api/mcp（Streamable HTTP） 设置和截图： https://easy2257.com/ai-assistant

此连接器读取一个账户自身的合规状态。它不是 Easy2257 Partner API；Partner API 是平台用于接收合规事件的独立集成接口。

Easy2257 保存成人内容制作方的 18 U.S.C. 2257 记录：场景中的人员、其身份已验证的证明、已签署的文件，以及证明记录在某个时间点已存在的证书。此连接器可让你已在使用的 AI 助手读取这些合规状态，并用通俗语言作答。

MCP 是一项开放的、与供应商无关的标准，因此一个连接即可服务于任何 MCP 客户端：Claude Code、网页版和桌面版 Claude、ChatGPT、Cursor、搭载 Copilot 的 VS Code、Windsurf、Gemini CLI、Codex CLI 等。

只读，并且刻意保持狭窄范围

此连接只报告状态。它不能创建场景、更改记录、签署任何内容、作出任何证明或花费资金。付费操作和证明均由人员在 easy2257.com 上主动完成。

返回的是合规状态：ID、公开代码（SCENE-、PROD-、LOG-）、状态、数量、日期、完整性哈希，以及你自己填写的简短标题；这些内容只会返回给拥有它们的账户。它绝不会返回表演者的姓名、出生日期、证件号码、图像、文件路径、地址或任何人的文件内容：这些列不会被选取。这是有意设定的边界，而非功能缺失；正因如此，该接口才可以安全地接入共享助手。

再次明确三项保证：

• 它只读取。 没有任何工具会创建、更改、签署或删除记录。
• 身份数据不会通过网络传输。 仅包含状态、代码、数量、日期、完整性哈希和你自己的标题。
• 不会发生资金转移。 没有任何工具会触及结账、场景激活或任何付费操作。

连接

有两种接入方式。两者都会访问你自己记录的同一个只读视图，工具无法区分它们。

登录（无需复制密钥）

适用于 ChatGPT、网页版和桌面版 Claude，以及任何带有连接器或集成设置页面的助手：添加指向 https://easy2257.com/api/mcp 的自定义连接器。助手会将你带到 Easy2257，你登录后批准只读访问。助手永远看不到密码或密钥。使用 OAuth 2.1 和 PKCE；唯一的作用域是 mcp:read。

粘贴密钥

适用于 Claude Code、Cursor、搭载 Copilot 的 VS Code、Windsurf、Gemini CLI、Codex CLI，以及其他允许你设置连接标头的工具。其中有几款也支持登录；两种方式都可以。前往 https://easy2257.com/profile/account/api-keys，在 Account，然后选择 MCP Keys 下创建密钥。密钥以 ez_mcp_ 开头，只显示一次，并以哈希和前四个字符的形式存储；设置页面据此区分不同密钥。你最多可以同时持有十个密钥，并可随时撤销其中任何一个。

命令行助手通常只需一行：

--header "Authorization: Bearer YOUR_KEY"

编辑器和其他助手通常使用配置块：

{
  "mcpServers": {
    "easy2257": {
      "type": "http",
      "url": "https://easy2257.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

以容器运行（无法设置标头的客户端）

有些 MCP 客户端只能通过 stdio 启动本地命令，无法附加标头。对于这些客户端，Docker Hub 上的 agaveis/easy2257-mcp 是一个小型镜像，可将 stdio 桥接到托管服务。它不包含任何服务代码：它运行按版本固定的官方 mcp-remote 包，并使用你的密钥作为 bearer token，将每个请求转发到 https://easy2257.com/api/mcp。服务仍由 Easy2257 托管；镜像只负责传输流。

docker run -i --rm -e EASY2257_API_KEY=YOUR_KEY agaveis/easy2257-mcp:latest

配置块示例：

{
  "mcpServers": {
    "easy2257": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "EASY2257_API_KEY", "agaveis/easy2257-mcp:latest"],
      "env": {
        "EASY2257_API_KEY": "YOUR_KEY"
      }
    }
  }
}

密钥保留在你的环境中，绝不会写入镜像或其日志。没有密钥时，容器会显示一条消息并退出，不执行任何操作。镜像由本仓库的 Dockerfile 和 bridge/ 构建，并通过 publish-dockerhub 工作流发布；基础镜像、每个软件包和每个操作都固定了版本。

每个已连接的助手（无论使用密钥还是登录）都会列在同一个设置页面中，并且可以一键断开连接。撤销后会立即终止访问权限。

所有 Easy2257 套餐均包含此功能。两个内容日志工具属于个人创作者套餐；在其他套餐中，这两个工具会拒绝请求并说明原因。

十六个工具

制作和场景

工具	可查询的信息
list_productions	你的制作项目及其文档状态和证书状态。
get_production	单个制作项目的逐场景信息。
get_scene_compliance	单个场景中每位参与者的状态：邀请状态、身份验证、表单和文档数量，以及模特授权书。参与者以角色和不透明 ID 显示，绝不显示姓名。
list_compliance_gaps	一次调用即可列出所有仍有待处理合规事项的场景，以便助手回答“哪些场景还需要处理事项？”。已取消的场景不包括在内；即将到期的文件由单独的工具查询。
list_expiring_documents	你选择的时间范围内即将到期的文件，并附有日期。所有已逾期的文件也会列出。

证书和归档

工具	可查询的信息
get_certificate	某个制作项目的合规证书及每份证书的当前状态。
verify_certificate	判断他人交给你的证书是否有效、已被替代或已撤销。
get_archive_status	已完成制作项目的封存归档哈希值。

你的账户

工具	可查询的信息
get_account_status	套餐、额度和已发布的托管方声明。
get_compliance_requirements	此平台适用的文档等级（分别列出）、参与者角色、导致出现缺口的检查项，以及此账户可使用的模板。
get_removal_requests_summary	与你自己的记录相关的移除和下架请求，按状态和法律依据分类。不包含请求提交者的信息。
list_notifications	账户通知。
list_webhook_deliveries	Webhook 传送结果。

个人创作者和公开代码

工具	可查询的信息
list_content_logs	个人创作者自己的内容日志。
get_content_log	单条内容日志。
verify_record	公开记录代码背后的证据状态；平台可通过此工具确认创作者提交的内容。

查询不属于你的代码时，会按凭据进行速率限制，无论你是登录还是粘贴密钥都一样。凭据额度耗尽后不会获知任何信息，甚至无法知道某个代码是否存在。通过 verify_record 查询你自己的记录是免费的。verify_certificate 始终会计入额度，即使查询的是你自己的证书也不例外；查询自己的证书请使用 get_certificate。

示例问题见 docs/example-prompts.md。

隐私

PRIVACY.md 说明了此连接器会传输哪些内容，以及绝不会传输哪些内容。托管服务的隐私政策位于 https://easy2257.com/privacy。

发布

server.json 是官方 MCP 注册表中 io.github.Agaveis/easy2257-mcp 对应的条目。它由 publish-registry 工作流重新发布，该工作流 通过 GitHub Actions OIDC 进行身份验证，因此无需交互式登录，也不需要存储凭据。

支持

问题与故障：https://easy2257.com/contact。

网站： https://easy2257.com 项目列表与源代码： https://github.com/Agaveis/easy2257-mcp 由位于亚利桑那州斯科茨代尔的 AgaveIS 构建并维护。