Emilia Protocol MCP Server

官方

为高影响代理操作提供精确动作审批与可验证签名收据。

分类: 其他第 158 / 230
Stars: ★ 611 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 17 天前

49FMRS · D

这是一个由上游团队维护的 MCP 服务器，指向 Emilia Protocol 的授权控制平面：在受保护执行边界上对精确动作做审批，并产出可离线验证的签名收据。它适合需要为自主代理建立有限授权和证据链的安全团队；它不替代身份、策略引擎或结算系统，且预防性只在完全中介的路径上成立。默认接口克制，扩展工具需显式开启环境变量。

最强项 · 文档质量 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

9/20

维护活跃度

11/20

文档质量

12/20

安装易用性

9/20

查看各项评分依据

可靠性 8/20: 静态审查仅能读取 server.json 与 README。清单声明 stdio 传输、npx 运行时、单一 npm 包 @emilia-protocol/[email protected]，入口路径明确；但仓库中未提供 server.json 之外的源码、工具 schema 或可核验的 CI 工作流文件，README 中的 badge、35 条安全声明、259 个证据文件、10,601+ 测试、Tamarin/Alloy/TLA+ 结果均为未经验证的自我陈述，不能作为执行证据。默认三工具与可选 EP_INCLUDE_PROTOCOL_TOOLS（握手/提交/委派）及 EP_INCLUDE_REGISTRY_TOOLS（36 工具遗留目录）之间存在显著能力面切换，声明行为与实际工具集是否一致无法确认。错误语义（INDETERMINATE、需对账而非重试）描述清晰，但缺乏可复现的错误码或测试样本。按静态校准上限 12 并因缺证保守下调，给 8 分。
安全与权限 9/20: 正面信号：EP_API_KEY 在清单中标注 isSecret:true 且 isRequired:false，只读凭据查询可无密钥运行，符合最小权限与降级可用；核心协议为 Apache-2.0 开源，README 明确承认‘Gate 只约束完全中介路径’、不声称覆盖全部执行路径、不主张 FIPS 认证或 IETF 采纳，回避了过度承诺。风险点：该服务器位于授权/支付/部署/删除仓库等后果性动作的执行边界，若 EP_INCLUDE_REGISTRY_TOOLS 打开即暴露 36 个遗留工具，默认面与扩展面破坏性差异大，而工具级确认策略、审计日志、消费者状态存储位置在可读证据中缺失；API key 通过环境变量注入，无密钥轮换或作用域说明。未发现恶意行为、凭据窃取、隐蔽外传或硬编码真实令牌，故不触发红线，但确认与作用域证据不完整，扣分后给 9 分。
维护活跃度 11/20: 有明确 Apache-2.0 许可证、语义化版本 2.1.2、公开仓库与官网、IETF 草稿组合及 Discord 社区渠道；README 引用了 SECURITY.md、THREAT_MODEL.md、GOVERNANCE.md、CONFORMANCE.md，暗示存在安全响应与治理路径。README 亦主动披露未完成项（租约边缘传播、可移植冻结事件证据、混合签名全栈未完成、SCITT 无透明服务接纳、外部 attested manifest 待补），显示一定的维护自省。扣分原因：本次审查未获得提交历史、发行节奏、issue 响应记录或依赖更新证据，无法验证持续维护；Issue 处于 15 个开放状态但无响应时效信息；元数据与文档版本号存在多处并列（0.5.0/0.6.0/2.1.2/16-suite 与 21-suite 双轨），版本治理线索复杂。给 11 分。
文档质量 12/20: 文档体量为该仓库最强项：README 分层清晰，区分 Identity/Policy/Authority 三层，给出 Mandate→Exact Work→Verify→Reserve+Enter→Reconcile 生命周期、三工具默认面与两个可选扩展面的环境变量说明、多语言集成示例（Python langchain-emilia、npm verify）、快速上手命令与 AEB-1 一致性测试入口。难得的是主动列出边界与否定声明（非身份系统、非结算轨道、非全量策略引擎、Internet-Draft 不等于 RFC），并标注 INDETERMINATE 语义与‘不盲目重试’。扣分：面向 MCP 客户端的工具参数级文档、逐个工具的输入输出 schema、错误码与计费/成本说明在可读证据中缺失；文档引用大量外部链接与统计数字无法在静态审查中核验，且存在大量‘草稿/归档不计为当前实现’的免责复述，增加读者判定成本，故未给高分，记 12 分。
安装易用性 9/20: 安装路径较明确：`npx -y @emilia-protocol/mcp-server` 即可加入 Claude/Cursor/Cline，stdio 传输无需端口，环境变量仅 EP_API_KEY 与两个可选开关，符合主流客户端接入习惯；另有 `npx @emilia-protocol/issue demo` 无需密钥的离线体验作为前置验证。扣分较重：npx 需从 npm 拉取并执行远程包，静态审查无法验证包内容与版本 2.1.2 是否与仓库一致；未提供逐客户端配置文件片段（如 claude_desktop_config.json 或 .mcp.json 示例）；生产可用性依赖自建 Gate、持久消费状态、固定密钥与包装器，与‘30 秒试用’的轻量印象存在落差；仓库根提供了 server.json 但服务器源码、依赖清单与 Node 版本要求未在可读证据中给出。按静态校准上限 15 并因缺证下调，给 9 分。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络修改第三方账户数据

适合谁

在 MCP 之上构建自主代理并需要授权控制平面的团队
需要精确动作审批与可验证证据的安全和平台工程团队
需要把人工或机构授权绑定到具体可执行对象的企业部署

不适合谁

希望替代 OAuth/OIDC、工作负载身份或策略引擎的项目
期望该服务器本身就是审计机构、认证机构或结算通道的用户
未在真实凭据路径上部署 Gate 就又期望获得预防性控制的场景

所需权限

EP_API_KEY 为写入与实时守卫操作所需的密钥（可选，公开收据查询可能无需）
服务器以本地 stdio 进程运行，可访问被配置的本地环境变量
启用 EP_INCLUDE_REGISTRY_TOOLS 后会暴露更多注册表与信誉工具接口

风险与副作用

预防性控制仅在完全中介的路径上成立，绕过执行点的路径不受约束
未配置 EP_API_KEY 时，写操作与实时动作守卫可能不可用
授权与准入不等于执行或产生效果；结果未知时必须走对账流程而非盲目重试
环境变量开启的扩展工具集会显著扩大暴露的工具面
官方 IETF 文档为个人 Internet-Draft，不代表 RFC 或 IETF 认可

安装接入

准备工作

运行环境：Node.js

EP_API_KEY 可选密钥用于实盘动作拦截、签批和写操作的 API 密钥；公开回执查询可无需此密钥，属于可选密钥。

其他可选配置项（2 个）

EP_INCLUDE_PROTOCOL_TOOLS 可选设为 true 时，在默认三工具入口之外额外暴露握手、提交和委托工具。

EP_INCLUDE_REGISTRY_TOOLS 可选设为 true 时，暴露完整的 36 个遗留注册与信誉目录工具。

在 MCP 客户端中通过 npx 启动服务器：npx -y @emilia-protocol/mcp-server。
若需实时动作守卫、签核与写操作，设置环境变量 EP_API_KEY（密钥，非必填；公开收据查询可能无需该密钥）。
如需额外暴露握手、提交与委派工具，设置 EP_INCLUDE_PROTOCOL_TOOLS=true。
如需暴露完整的 36 工具遗留注册表与信誉目录，设置 EP_INCLUDE_REGISTRY_TOOLS=true。
重启客户端并确认服务器已连接。

claude_desktop_config.json

{
  "mcpServers": {
    "emilia-protocol": {
      "command": "npx",
      "args": [
        "-y",
        "@emilia-protocol/mcp-server"
      ],
      "env": {
        "EP_API_KEY": ""
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "emilia-protocol": {
      "command": "npx",
      "args": [
        "-y",
        "@emilia-protocol/mcp-server"
      ],
      "env": {
        "EP_API_KEY": ""
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add emilia-protocol -e EP_API_KEY= -- npx -y @emilia-protocol/mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

将服务器添加到 MCP 客户端后，工具列表中应出现 Emilia Protocol 的默认三工具动作入口（动作请求/追踪/验证）；运行 `npx -y @emilia-protocol/mcp-server` 确认进程正常启动，或运行 `npx @emilia-protocol/issue demo` 离线签发一张回执以确认安装可用。

常见排障

确认使用 npx 能拉取到 @emilia-protocol/mcp-server 且网络可达 npm registry
若写操作失败，检查 EP_API_KEY 是否已设置且有效
若看不到握手、提交、委派工具，检查 EP_INCLUDE_PROTOCOL_TOOLS 是否设为 true
若看不到注册表与信誉工具，检查 EP_INCLUDE_REGISTRY_TOOLS 是否设为 true
重启 MCP 客户端后确认 stdio 进程已启动且无启动错误输出

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我签发一张演示用的授权回执（npx @emilia-protocol/issue demo 风格）。
验证这份已签名回执的真实性并给出验证结果。
在发布付款操作前，为这个 action 请求精确审批并追踪其状态。

使用场景

将代理的高影响操作（如支付放行、删除仓库、生产部署）绑定到精确动作的授权收据

在受保护执行边界上请求、跟踪并离线验证签名收据

为自主代理建立有限任务授权，防止代理悄悄扩大权限

为审计与合规场景保留可移植的证据链

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Emilia Protocol MCP 服务器为自主代理的高影响操作提供精确动作审批：通过 stdio 传输运行，使用 npx 启动 npm 包 @emilia-protocol/mcp-server。按 manifest 描述，它用于请求、跟踪并验证签名收据，是 Emilia Gate 授权控制平面在 MCP 层的入口，默认只暴露三个工具的动作入口，可通过环境变量扩展握手、提交、委派工具以及 36 个遗留注册表与信誉工具。该服务器由 Emilia Protocol 上游团队维护（official 为真），属于 agent-security / zero-trust 方向的授权与证据组件，而非身份系统、钱包、结算通道或通用策略引擎。它不要求每个动作都必须由人工批准：授权可以由有限任务授权、有界能力、法定人数或依赖方组合的原生证据提供。注意适用范围：仅当部署完全中介了受保护路径时才具备预防性，绕过执行点的路径不受约束。