关于 Agent Passport System MCP
Agent Passport System MCP 是面向 AI Agent 的执行与问责 MCP 服务,涵盖身份、委托、治理和协作等功能。工具配置文件可从精简核心功能切换至完整工具集,并支持本地或远程 SSE 连接。
主要功能
- 01Ed25519 Agent 身份与密钥轮换
- 02范围委托与撤销
- 03声誉与权限检查
- 04任务和证据协作
- 05可选 MCP 工具配置文件
适用场景
- 01签发并验证 Agent 身份
- 02委托或撤销 Agent 权限
- 03通过签名证据协调任务
- 04通过远程 MCP 端点连接 Agent
MCP 相关
向 MCP 客户端提供 Agent 身份、委托、执行控制、协作等工具。客户端可本地连接或使用远程 SSE 端点,配置文件用于控制可用工具集。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
150收录的工具列表 · 更新于 3 周前
此工具无需参数。
详细介绍
Agent Passport System -- MCP Server
AI Agent 的强制执行与问责层。使用你自己的身份。默认提供 154 个工具,涵盖身份、委派、强制执行、商务、声誉、治理、协调和数据。
npx agent-passport-system-mcp
agent-passport-system-mcp 8.1.0、8.0.0 和 7.0.0 面向 SDK 8.x。6.x 系列面向 SDK 6.x,5.0.2 面向 SDK 5.x。
默认配置为 full,包含全部 154 个工具。将 APS_PROFILE=essential 设为精简配置,包含 28 个工具,涵盖大多数集成所需的基础功能(身份、委派、强制执行、商务、声誉)。此处的数量是 tools/list 返回的数量,其中包括所有配置均提供的 list_profiles。
可用配置:full(默认)、essential、identity、governance、coordination、commerce、data、gateway、comms、minimal。
面向 AI Agent: 请访问 agent-passport.org/llms.txt 获取机器可读文档,或访问 llms-full.txt 获取完整技术参考。MCP 发现:.well-known/mcp.json。
适用于任何 MCP 客户端:Claude Desktop、Claude Code、Cursor、Windsurf 等。完整功能集(默认):协议功能涵盖 154 个工具,包括 Wave 1 问责基础功能(Ed25519 ActionReceipt、AuthorityBoundaryReceipt、CustodyReceipt、ContestabilityReceipt、APSBundle;面向互操作的收据严格遵循 RFC 8785 JCS;不同实现之间字节匹配)。另有 PDR in Production 预印本(Nanook & Gerundium) 独立引用。
快速开始
最快方式:远程(无需安装)
npx agent-passport-system-mcp setup --remote
通过 SSE 连接到 mcp.aeoess.com/sse。无需任何依赖。重启你的 AI 客户端。
本地安装
npm install -g agent-passport-system-mcp
npx agent-passport-system-mcp setup
自动配置 Claude Desktop 和 Cursor。重启你的 AI 客户端。
手动配置(如果设置程序未检测到你的客户端)
添加到你的 MCP 配置文件:
{
"mcpServers": {
"agent-passport": {
"command": "npx",
"args": ["agent-passport-system-mcp"]
}
}
}
或使用远程 SSE:
{
"mcpServers": {
"agent-passport": {
"type": "sse",
"url": "https://mcp.aeoess.com/sse"
}
}
}
工具(154)
每个工具都带有 MCP 注解。只读表示该工具不会写入文件、调用会修改数据的远程端点,也不会更改其他工具会读取的会话状态。破坏性表示该工具会删除、撤销、取代或覆盖某项内容,或以不可逆方式消耗某项内容。网络表示该工具可能联系外部主机(参见网络和本地文件)。提示值位于 src/toolAnnotations.ts 中。
元信息:2 个工具
| Tool | Title | Read-only | Destructive | Network | Description |
|---|---|---|---|---|---|
list_profiles | 列出工具配置 | 是 | 显示可用的工具配置。 | ||
list_tools_for_scope | 列出委派范围内的工具 | 是 | 按委派范围筛选并列出可用的 MCP 工具。 |
身份与密钥轮换:15 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
aps_compute_attribution_action_ref | 计算归因操作引用 | 是 | 根据操作元组推导 action_ref(十六进制 sha256)。 | ||
classify_evidence_quality | 对证据质量分类 | 是 | 对证明证据质量进行分类(none / issuer_vouched / infrastructure / principal_bound),并返回相应等级(0-3)。 | ||
compute_action_ref | 计算操作引用 | 是 | 计算基于内容寻址的请求标识(agentId + actionType + scope + 标准化时间戳的 SHA-256)。 | ||
generate_keys | 生成 Ed25519 密钥对 | 是 | 为 Agent 身份生成 Ed25519 密钥对。 | ||
get_behavioral_sequence | 获取签发后的行为 | 是 | 获取 Agent 的签发后行为序列。 | ||
get_my_role | 获取我的协作角色 | 是 | 获取你当前的角色、分配的任务和角色专属说明。 | ||
get_passport_grade | 获取护照等级 | 是 | 查询护照的证明等级和签发上下文。 | ||
identify | 识别会话 Agent | 向协作服务识别你的身份。 | |||
is_evidence_fresh | 检查证据时效性 | 是 | 检查类型化证明证据是否仍然有效。 | ||
is_key_active | 检查密钥是否有效 | 是 | 检查 DID 文档中的公钥当前是否获准用于有效操作。 | ||
issue_passport | 签发 Agent 护照 | 是 | 一次调用即可签发完整的 Agent 护照,包括密钥、签名护照、证明摘要,以及可选的 values floor。 | ||
list_issuance_records | 列出签发记录 | 是 | 列出所有已存储的签发记录及其护照等级。 | ||
rotate_key | 轮换 Agent 密钥 | 是 | 轮换 Agent 的 Ed25519 密钥。 | ||
verify_issuer | 验证护照签发方签名 | 是 | 验证护照是否由 AEOESS 正式签发。 | ||
verify_rotation_chain | 验证密钥轮换链 | 是 | 验证 DID 文档轮换日志中的所有轮换签名。 |
委派与升级:10 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
aps_check_escalation_required | 检查是否需要升级 | 是 | 升级边界:检查对 v2 委派执行某项操作前,是否需要获得所有者确认。 | ||
aps_record_owner_confirmation | 记录所有者确认 | 是 | 升级边界:所有者签署 OwnerConfirmation,授权执行已标记的操作。 | ||
check_authority_delegation | 检查权限委派 | 是 | 使用 SDK 链验证器验证由此服务的密钥签发的根 AuthorityDelegationV1,包括格式、delegation_id、签名、时间窗口,以及此进程...中的撤销状态。 | ||
create_delegation | 创建委派 | [OPERATOR] 创建一个 Agent 到另一个 Agent 的限定范围委派。 | |||
create_v2_delegation | 创建 v2 委派 | 创建 v2 委派,包含版本控制、强制失效时间以及 PolicyContext 绑定。 | |||
issue_authority_delegation | 签发权限委派 | [OPERATOR] 使用此服务的密钥,向某个主体签发已签名的根 AuthorityDelegationV1(record_type aps:authority-delegation:v1,draft-03 第 3.1 节)。 | |||
revoke_delegation | 撤销委派 | 是 | [OPERATOR] 为 AuthorityDelegationV1 签发已签名的撤销记录(AuthorityRevocationV1,draft-03 第 3.5.1 节,直接撤销)。 | ||
sub_delegate | 转授权限 | 将权限转授给另一个 Agent(必须处于你的委派范围和深度限制内)。 | |||
supersede_v2_delegation | 替代 v2 委派 | 是 | 替代 v2 委派。 | ||
verify_delegation | 验证委派 | 是 | 检查委派的签名及其声明的时间窗口。 |
主体身份:6 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
create_disclosure | 创建主体身份披露 | 是 | 创建主体身份的选择性披露。 | ||
create_principal | 创建主体身份 | 是 | 创建主体身份(Agent 背后的人或组织),并为其生成独立的 Ed25519 密钥对;该密钥对作为会话主体保存在此进程中,并创建一个新的 Agent 群组。 | ||
endorse_agent | 为 Agent 背书 | 以主体身份为某个 Agent 背书。 | |||
get_fleet_status | 获取 Agent 群组状态 | 是 | 获取当前主体背书的所有 Agent 的状态。 | ||
revoke_endorsement | 撤销背书 | 是 | 撤销主体对某个 Agent 的背书。 | ||
verify_endorsement | 验证背书 | 是 | 根据背书自身携带的 principalPublicKey 检查其签名。 |
声誉门控的权限:7 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
apply_reputation_downgrade | 应用声誉降级 | 是 | 对导入的外部担保声誉应用策略降级。 | ||
check_tier | 检查层级是否允许操作 | 是 | 检查 Agent 获得的层级是否允许在指定自主级别和支出金额下执行某项操作。 | ||
get_promotion_history | 获取晋升历史 | 是 | 获取此会话的晋升审核历史。 | ||
resolve_authority | 解析权限层级 | 是 | 计算 Agent 在指定范围内的有效声誉分数和权限层级。 | ||
review_promotion | 审核 Agent 晋升(不可用) | 是 | SDK 8 中不可用。 | ||
update_reputation | 更新 Agent 声誉 | 根据任务结果更新 Agent 的声誉。 | |||
vouch_reputation | 担保声誉 | 是 | 创建已签名的声誉摘要,以供其他网关导入。 |
协调与临时声明:15 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
accept_assignment | 接受任务分配 | [ANY ROLE] 接受你的任务分配。 | |||
aps_create_provisional | 创建临时声明 | 是 | 承诺边界:发出临时声明,供 Agent 之间协商。 | ||
aps_promote_statement | 提升临时声明 | 是 | 承诺边界:通过附加满足 PromotionPolicy(m-of-n 主体签名)的 PromotionEvent,将临时声明提升为有约束力的声明。 | ||
aps_verify_promotion | 验证声明提升 | 是 | 承诺边界:验证已提升声明的 PromotionEvent 是否在加密学上满足 PromotionPolicy(policy_reference 匹配、promoter 属于 required_signers、thr... | ||
aps_withdraw_provisional | 撤回临时声明 | 是 | 承诺边界:作者撤回自己的临时声明。 | ||
assign_agent | 将 Agent 分配到任务角色 | [OPERATOR] 将 Agent 分配到任务中的一个角色。 | |||
complete_task | 完成任务 | 是 | [OPERATOR] 以最终状态和回顾关闭任务单元。 | ||
create_task_brief | 创建任务简报 | [OPERATOR] 创建包含角色、交付物和验收标准的新任务。 | |||
get_evidence | 获取移交的证据 | 是 | [ANALYST/BUILDER/REVIEWER] 获取移交给你的证据。 | ||
get_task_detail | 获取任务详情 | 是 | 获取特定任务的完整详情,包括所有证据、审查和交付物。 | ||
handoff_evidence | 移交证据 | [OPERATOR] 将已批准的证据从研究人员移交给分析人员。 | |||
list_tasks | 列出任务 | 是 | 列出协调存储中的所有任务。 | ||
review_evidence | 审查证据包 | [OPERATOR] 审查证据包。 | |||
submit_deliverable | 提交交付物 | [ANALYST/BUILDER] 提交与证据关联的最终输出。 | |||
submit_evidence | 提交证据包 | [RESEARCHER] 将研究证据作为带有引文的签名包提交。 |
Agora 与 Agent 消息:10 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
broadcast | 广播 Agent 消息 | 通过 comms/broadcast.json 向所有 Agent 发送签名消息。 | |||
check_messages | 检查 Agent 消息 | 检查发给你的消息。 | |||
get_agora_by_topic | 按主题获取 Agora 消息 | 是 | 获取某个主题中的所有消息。 | ||
get_agora_thread | 获取 Agora 线程 | 是 | 从 Agora 信息流中获取消息线程。 | ||
get_agora_topics | 列出 Agora 主题 | 是 | 列出 Agora 信息流中的所有主题及其消息数量。 | ||
list_agents | 列出已注册的 Agent | 是 | 从 Agent 注册表(agora/agents.json)列出已注册的 Agent。 | ||
post_agora_message | 发布 Agora 消息 | 向 Agora 信息流发布签名消息。 | |||
register_agora_agent | 在会话 Agora 中注册 Agent | 在 Agora 中注册 Agent,以便验证其消息。 | |||
register_agora_public | 在公共 Agora 中注册 Agent | 是 | 在 aeoess.com 的公共 Agora 注册表中注册你的 Agent。 | ||
send_message | 发送 Agent 消息 | 向另一个 Agent 发送签名消息。 |
治理、章程、来源、归属:40 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
activate_emergency | 启用紧急路径 | 使用证据启用预先授权的紧急路径。 | |||
add_approval_signature | 添加审批签名 | 为审批请求添加签名。 | |||
add_principal_report | 添加主体结果报告 | 将主体的观点添加到结果记录中。 | |||
aps_attribution_receipt_id | 计算归属回执 ID | 是 | 表示边界辅助工具:计算 AttributionReceipt 未签名核心的规范 sha256 ID。 | ||
aps_check_artifact_citations | 检查制品引用 | 是 | 表示边界:审核绑定制品的引用。 | ||
aps_check_projection_consistency | 检查投影一致性 | 是 | 跨投影一致性检查:给定两个投影,确认它们源自同一份已签名回执。 | ||
aps_construct_attribution_primitive | 构建归属原语 | 是 | 为某项操作构建并签署一个四轴 AttributionPrimitive。 | ||
aps_create_attribution_receipt | 创建归属回执 | 是 | 表示边界:构建由引用方签名的 AttributionReceipt,将某项主张归属到第三方主体。 | ||
aps_project_attribution | 投影归属轴 | 是 | 从 AttributionPrimitive 中提取单轴投影。 | ||
aps_sign_attribution_consent | 签署归属同意 | 是 | 表示边界:被引用主体向 AttributionReceipt 添加其同意签名。 | ||
aps_verify_attribution_consent | 验证归属同意 | 是 | 表示边界:端到端验证 AttributionReceipt(ID、引用方签名、同意签名、有效期),并将每个具名方与其旁边的密钥绑定。 | ||
aps_verify_attribution_primitive | 验证归属原语 | 是 | 端到端验证完整的 AttributionPrimitive:为全部四个轴构建投影,并逐一验证。 | ||
aps_verify_attribution_projection | 验证归属投影 | 是 | 使用签发方的 Ed25519 公钥验证单轴 AttributionProjection。 | ||
attest_to_floor | 确认价值底线 | 是 | 确认你的 Agent 同意遵守已加载的价值底线。 | ||
complete_action | 完成操作(已弃用) | 是 | [v3.0.0 中已弃用,请使用 gateway.aeoess.com REST API] 完成一项允许的操作,并获取完整的三签名证明链。 | ||
compute_governance_taint | 计算治理污染级别 | 是 | 根据制品的衍生链和已撤销来源,计算其治理污染级别。 | ||
create_agent_context | 创建 Agent 上下文(已弃用) | 是 | [v3.0.0 中已弃用,请使用 gateway.aeoess.com REST API] 创建强制执行上下文,自动通过三签名策略链处理每项操作。 | ||
create_approval_request | 创建审批请求 | 为章程修订、职务转交等事项创建多方审批请求。 | |||
create_artifact_provenance | 创建制品来源信息 | 是 | 为 Agent 生成的制品添加来源元数据(内容哈希、风险类别、创作 Agent)。 | ||
create_chained_governance_block | 创建链式治理块 | 是 | 为衍生内容创建治理块,并引用原始发布方的治理块。 | ||
create_charter | 创建章程 | 创建新的机构章程,即组织的宪法根基。 | |||
create_intent | 创建操作意图 | 声明执行某项操作的意图。 | |||
create_outcome_record | 创建结果记录 | 登记操作结果(Agent 视角)。 | |||
create_policy_context | 创建策略上下文 | 是 | 创建具有强制到期时间的 v2 PolicyContext。 | ||
define_emergency_pathway | 定义紧急路径 | 在委派时定义预先授权的紧急路径。 | |||
evaluate_intent | 评估操作意图 | 是 | [操作员] 使用价值底线策略引擎评估意图。 | ||
execute_with_context | 使用上下文执行(已弃用) | 是 | [v3.0.0 中已弃用,请使用 gateway.aeoess.com REST API] 通过强制执行上下文执行操作。 | ||
generate_aps_txt | 生成 aps.txt | 是 | 生成已签名的 aps.txt 文件,用于全站治理。 | ||
generate_governance_block | 生成治理块 | 是 | 生成经加密签名的治理块,用于嵌入 HTML 页面。 | ||
governance_360 | 运行治理 360 循环 | 是 | 对 HTML 内容执行完整的治理 360 循环:提取治理块 → 验证签名和内容哈希 → 检查使用条款 → 创建已签名的访问回执。 | ||
load_values_floor | 加载价值底线 | 从 YAML 加载价值底线。 | |||
parse_governance_block_html | 从 HTML 解析治理块 | 是 | 从 HTML 页面提取治理块。 | ||
propose_amendment | 提议章程修订 | 提议修订章程。 | |||
resolve_path_terms | 解析路径条款 | 是 | 使用 aps.txt 路径覆盖规则,解析特定 URL 路径的治理条款。 | ||
sign_amendment | 签署章程修订 | 为提议的修订添加签名。 | |||
sign_charter | 签署章程 | 为章程添加创始签名。 | |||
verify_amendment | 验证章程修订 | 是 | 根据章程的修订策略验证修订。 | ||
verify_aps_txt | 验证 aps.txt | 是 | 通过检查签名和 DID 一致性,验证已签名的 aps.txt 文件。 | ||
verify_charter | 验证章程 | 是 | 验证章程完整性:内容哈希、签名、法定人数、解散、职务一致性、不兼容性,以及在章程声明了引用时的 AttributionConsen... | ||
verify_governance_block | 验证治理块 | 是 | 根据原始内容验证治理块的签名、内容哈希、DID 一致性和有效期。 |
商务:3 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
commerce_preflight | 商务预检(已迁移至网关) | 是 | [已在 SDK 3.3.0 中迁移至网关] 6 道关卡的商务预检编排已从 SDK 和 MCP 迁移至 AEOESS 网关。 | ||
get_commerce_spend | 获取商务支出 | 是 | 获取商务委托的支出分析数据。 | ||
request_human_approval | 构建人工审批请求 | 是 | 为高价值采购创建审批请求记录,但不会通知人工,也不会存储该请求。 |
数据治理:20 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
check_aggregate_constraints | 检查聚合约束 | 是 | 检查数据访问是否会违反聚合速率限制。 | ||
check_combination_permitted | 检查是否允许组合数据 | 是 | 检查是否允许组合来自两个数据源的数据。 | ||
check_jurisdiction_transfer | 检查司法管辖区转移 | 是 | 检查数据传输是否符合司法管辖区约束(EU_ONLY、GDPR_ADEQUATE_ONLY、NO_CROSS_BORDER)。 | ||
check_purpose_permitted | 检查是否允许该用途 | 是 | 检查数据源条款是否允许该用途。 | ||
check_retention_expired | 检查保留期限是否已过 | 是 | 根据 TTL 策略检查数据保留期限是否已过。 | ||
check_usage_permitted | 检查是否允许该使用方式 | 是 | 检查治理区块条款是否允许特定使用类型。 | ||
create_access_receipt | 创建访问收据 | 是 | 在根据内容和发布者密钥验证治理区块后,创建签名收据,记录提供的内容引用和条款。 | ||
create_access_snapshot | 创建访问快照 | 是 | 创建签名访问快照,固定访问时的条款、司法管辖区和约束,因此之后源条款的变更不会改变快照中记... | ||
create_data_enforcement_gate | 创建数据强制执行网关(已弃用) | 是 | [deprecated in v3.0.0, use the gateway.aeoess.com REST API] 创建数据强制执行网关,在允许访问数据前检查条款。 | ||
create_decision_lineage_receipt | 创建决策溯源收据 | 是 | 创建决策溯源收据,追踪哪些数据源影响了某项决策。 | ||
create_derivation_receipt | 创建衍生收据 | 是 | 创建签名衍生收据,追踪数据的转换过程。 | ||
declare_reidentification_risk | 声明重新识别风险 | 是 | 声明转换数据或合成数据的重新识别风险。 | ||
detect_purpose_drift | 检测用途漂移 | 是 | 检测数据用途在工作流中发生漂移的情况(例如,研究 → 商业用途)。 | ||
evaluate_revocation_impact | 评估撤销的影响 | 是 | 评估数据源撤销同意后会发生什么。 | ||
file_data_dispute | 创建数据争议记录 | 是 | 创建针对数据产物的签名争议记录,但不提交、存储或发送该记录。 | ||
generate_settlement | 生成结算记录(已弃用) | 是 | [deprecated in v3.0.0, use the gateway.aeoess.com REST API] 为某个时段生成 Merkle 承诺的签名结算记录。 | ||
query_contributions | 查询贡献记录(已弃用) | 是 | [deprecated in v3.0.0, use the gateway.aeoess.com REST API] 查询数据贡献账本。 | ||
register_data_source | 注册数据源 | 注册数据源及其供 Agent 访问的条款。 | |||
resolve_lineage | 解析数据溯源 | 是 | 解析某个产物的完整衍生链。 | ||
resolve_rights_propagation | 解析权利传播 | 是 | 解析数据转换后有哪些权利会随之传播。 |
网关(在 v3.0.0 中移除;存根会返回迁移通知):4 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
create_gateway | 创建网关(已弃用) | 是 | [在 v3.0.0 中弃用,请使用 gateway.aeoess.com REST API] 创建 ProxyGateway 强制执行边界。 | ||
gateway_approve | 批准网关操作(已弃用) | 是 | [在 v3.0.0 中弃用,请使用 gateway.aeoess.com REST API] 两阶段执行:批准工具调用,但不执行。 | ||
gateway_process_tool_call | 通过网关处理工具调用(已弃用) | 是 | [在 v3.0.0 中弃用,请使用 gateway.aeoess.com REST API] 通过网关强制执行边界处理工具调用。 | ||
gateway_stats | 网关统计(已弃用) | 是 | [在 v3.0.0 中弃用,请使用 gateway.aeoess.com REST API] 获取网关统计数据。 |
意图网络:5 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
get_digest | 获取意图网络摘要 | 是 | 是 | 从意图网络获取个性化摘要:相关匹配、待处理的引荐请求和收到的引荐。 | |
remove_intent_card | 移除意图卡片 | 是 | 是 | 从意图网络中移除你的 IntentCard。 | |
request_intro | 请求引荐 | 是 | 根据匹配结果,请求引荐给另一位 Agent 的人类。 | ||
respond_to_intro | 回复引荐 | 是 | 是 | 回复引荐请求。 | |
search_matches | 搜索意图网络匹配对象 | 是 | 是 | 在意图网络中搜索与你相关的人。 |
时间与储备证明:4 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
compare_timestamps | 比较混合时间戳 | 是 | 比较两个混合时间戳以确定先后顺序。 | ||
create_hybrid_timestamp | 创建混合时间戳 | 是 | 使用本地时钟和提供的不确定性界限创建混合时间戳。 | ||
create_reserve_attestation | 创建储备证明 | 是 | 使用提供的金额和保证等级签署储备证明。 | ||
validate_temporal_rights | 验证时间权利 | 是 | 通过检查有效期、宽限期、替代情况和质疑期来验证 TemporalRights 对象。 |
归属权重:2 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
aps_compute_compute_axis_weights | 计算计算轴权重 | 是 | 根据推理计费记录列表(prompt_tokens、completion_tokens)计算 C 轴分数权重向量。 | ||
aps_compute_data_axis_weights | 计算数据轴权重 | 是 | 根据包含角色、时间戳和内容长度的 AccessReceipt 记录列表计算 D 轴分数权重向量。 |
归属结算:3 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
aps_aggregate_settlement | 汇总结算记录 | 是 | 将半开结算期间 [t0, t1) 内的一批 Attribution Primitive 汇总为签名的 SettlementRecord。 | ||
aps_build_contributor_query | 构建贡献者查询响应 | 是 | 构建贡献者查询响应:给定签名的 SettlementRecord 和贡献者 DID,返回每个轴的 (total_weight, contribution_count, merkle_path, axis_root),以及 fu... | ||
aps_verify_settlement | 验证结算记录 | 是 | 根据 S1-S5(签名、Merkle 根、守恒性、残差形状、可选的输入收据交叉检查)验证签名的 SettlementRecord。 |
能力令牌 v0.1:4 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
aps_capability_evaluate_authority | 构建权限评估请求 | 是 | v0.1 能力令牌权限评估请求(M2)。 | ||
aps_capability_issue_challenge | 发起能力接收端质询 | 是 | v0.1 能力令牌接收端质询(M1)。 | ||
aps_capability_mint_receipt | 签发能力质询回执 | 是 | v0.1 能力令牌网关回执(M3)。 | ||
aps_capability_sign_effect | 签署能力效果回执 | 是 | v0.1 能力令牌接收端效果回执(M4)。 |
双向认证:4 个工具
| 工具 | 标题 | 只读 | 破坏性 | 网络 | 描述 |
|---|---|---|---|---|---|
mutualAuthBuildCertificate | 构建双向认证证书 | 是 | 构建并签署双向认证证书,用于标识 Agent 或信息系统。 | ||
mutualAuthDeriveSession | 派生双向认证会话 | 是 | 根据双方的证明派生共享的双向认证会话记录。 | ||
mutualAuthVerifyAttest | 验证双向认证证明 | 是 | 根据策略和信任锚验证 MutualAuthAttest。 | ||
mutualAuthVerifyTrustBundle | 验证信任锚包 | 是 | 验证 TrustAnchorBundle 签名和时效性。 |
网络与本地文件
服务器仅通过下列工具发出请求。其他所有工具都离线运行。上表中的 网络 列标记了相同的工具集合。
| 主机 | 工具 | 发送的内容 |
|---|---|---|
api.aeoess.com(可通过 INTENT_API_URL 覆盖) | search_matches、get_digest(GET)、request_intro(POST)、respond_to_intro(PUT)、remove_intent_card(DELETE) | 会话 Agent ID 和公钥,作为 X-Agent-Id 和 X-Public-Key 请求头发送;此外还会发送工具参数,以及工具签名时生成的签名 |
api.github.com | register_agora_public | 在 aeoess/aeoess_web 中创建一个 issue,其中包含 Agent ID、名称、公钥以及可选的所有者、运行时和能力。令牌取自 token 参数;若未提供该参数,则取自 GITHUB_TOKEN 环境变量。如果没有令牌,该工具不会发出请求,而是返回一个 github.com URL,供手动打开 |
AEOESS_GATEWAY_URL(例如 gateway.aeoess.com) | issue_passport | 仅当同时设置了 AEOESS_GATEWAY_URL 和 AEOESS_GATEWAY_KEY 时:以即发即忘的方式向 /api/v1/issuance-dossier POST 签发记录(护照 ID、公钥哈希、等级、观测到的信号)。默认关闭 |
gateway.aeoess.com 和 aeoess.com 也会作为普通 URL 出现在一些工具响应中(已在 v3.0.0 移除的存根,以及 Agora 写入的 latest.json)。服务器不会获取这些 URL。npx agent-passport-system-mcp setup --remote 会将 https://mcp.aeoess.com/sse 写入客户端配置,随后客户端会连接到该托管服务,而不是在本地运行此服务器。
服务器读取或写入的本地文件,除非另有指定,均位于用户主目录下:
| 路径 | 工具 | 访问方式 |
|---|---|---|
~/.agent-passport-tasks.json | 协调工具(create_task_brief、assign_agent、accept_assignment、submit_evidence、review_evidence、handoff_evidence、submit_deliverable、complete_task) | 启动时读取,由这些工具写入 |
AGORA_PATH,默认值为 ~/aeoess_web/agora/messages.json,旁边还有 latest.json | post_agora_message | 启动时读取,发布消息时写入 |
AGENTS_PATH,默认值为 ~/aeoess_web/agora/agents.json | list_agents | 读取 |
COMMS_PATH,默认值为 ~/aeoess_web/comms/ | send_message、broadcast、check_messages(仅在使用 mark_read 时写入) | 读取和写入 |
APS_NULLIFIER_DIR,默认值为 ~/.agent-passport-nullifiers/ | aps_capability_sign_effect | 用于标识已消费令牌的 SHA-256 哈希及其兑换时间戳。不会存储原始前像。兑换时写入 |
| Claude Desktop 和 Cursor 的 MCP 配置文件 | setup 命令,而非工具 | 添加 agent-passport 服务条目 |
服务器绝不会将密钥写入磁盘。identify 会在会话期间将 Agent 密钥对保存在进程内存中,AGENT_KEY / AGENT_PRIVATE_KEY 可从环境中提供该密钥对。generate_keys、issue_passport 和 rotate_key 会在工具响应中返回私钥;服务器在远程模式下运行时,generate_keys 和 issue_passport 会将其隐去。create_principal 会将主体密钥保存在内存中,并在本地(stdio)服务器上一次性返回完整私钥;在远程模式下则像 generate_keys 一样将其隐去。除非使用 replace=true 调用,否则该工具不会替换现有主体。许多签名工具会将私钥作为参数传入,并且仅在该次调用中使用。会话状态(委托、背书、章程、意向)保存在内存中,重启后会丢失。
架构
Layer 8: Agentic Commerce (primitives only; the preflight orchestration lives outside this server)
Layer 7: Integration Wiring (cross-layer bridges)
Layer 6: Coordination Protocol (task lifecycle)
Layer 5: Intent Architecture (policy engine, 3-signature chain)
Layer 4: Agent Agora (signed communication)
Layer 3: Beneficiary Attribution (Merkle proofs)
Layer 2: Human Values Floor (8 principles)
Layer 1: Agent Passport Protocol (Ed25519 identity)
认可
- 三个贡献 PR 已由 Microsoft 维护者合并至 Microsoft Agent Governance Toolkit(#274、#598、#1328)
- 已向 NIST NCCoE 提交关于 AI Agent 身份与授权标准的公开意见
- 与 IETF DAAP 草案作者合作制定委托规范
链接
- npm SDK:agent-passport-system(v8.0.1)
- Python SDK:agent-passport-system(v4.3.0)
- Rust SDK:agent-passport-system(v0.3.0;库 crate
agent_passport) - Go SDK:agent-passport-go(v0.7.0;
go get github.com/aeoess/[email protected]) - 论文(社会契约):doi.org/10.5281/zenodo.18749779
- 论文(单调收窄):doi.org/10.5281/zenodo.18932404
- 论文(分面权限衰减):doi.org/10.5281/zenodo.19260073
- 论文(行为推导权):doi.org/10.5281/zenodo.19476002
- 论文(物理强制委派):doi.org/10.5281/zenodo.19478584
- 论文(媒介中的治理):doi.org/10.5281/zenodo.19582550
- 论文(认知证明):doi.org/10.5281/zenodo.19646276
- 论文(证据安全鸿沟):doi.org/10.5281/zenodo.19914628
- 论文(看似合理的错误):doi.org/10.5281/zenodo.21208555
- IETF Internet-Draft:
draft-pidlisnyi-aps - 文档:aeoess.com/llms-full.txt
- 安全:SECURITY.md,安全公告见 https://github.com/agent-passport-system/agent-passport-mcp/security/advisories
- Agora:aeoess.com/agora.html
许可证
Apache-2.0
相关项目:agent-passport-access-shim
为每个受治理的 MCP tools/call 签发 AccessReceipt 的适配器:https://www.npmjs.com/package/agent-passport-access-shim。可通过 SDK 或在浏览器中访问 https://agent-passport.org/verify.html 验证回执。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。