Verimand MCP Authority Server

Verimand MCP 权限服务

MCP 提供能力。VAGP 管理权限。

Verimand MCP Authority Server 为兼容 MCP 的客户端提供 Agent 原生访问能力，以使用可验证的 VAGP 权限。它提供一组精简的 stdio 工具，用于查询受信任的已注册 Agent 当前是否拥有权限、检查受信任的权限状态，以及验证 VAGP 执行许可。

工具可用并不意味着获得权限。此服务目前尚不是受保护工具执行的强制执行网关。

软件包标识

• npm 软件包：@verimand/mcp-authority-server
• MCP Registry 服务名称：dev.verimand/mcp-authority-server
• 当前版本：0.1.0
• 运行时：Node.js 22 或更高版本
• MCP SDK/运行时：@modelcontextprotocol/server 2.0.0，实施 MCP 2026-07-28 规范，并兼容旧版 stdio

工具

• verimand.resolve 判断受信任的已注册 Agent 是否有权执行某项操作，并且仅在确认拥有权限时返回 VAGP 执行许可。
• verimand.explain 解释确定性的权限决策或基于许可的数据。此工具仅供参考。
• verimand.get_authority 返回与某个 Agent/操作相关的有限权限信息。
• verimand.get_mandate 获取服务端受信任的授权元数据。
• verimand.get_agent_dna 返回服务端受信任的 Agent DNA 状态及指纹信息。
• verimand.verify_permit 根据当前权限证据验证 VAGP 执行许可。

安装并启动

本地 MCP 客户端可以通过以下命令启动已发布的服务：

npx -y @verimand/[email protected]

在此公开代码仓库中运行时：

npm ci
node dist/stdio.js

该进程通过 stdio 使用 MCP 通信。stdout 专用于 MCP 协议消息；诊断信息会输出到 stderr。

MCP 客户端配置示例

{
  "mcpServers": {
    "verimand-authority": {
      "command": "npx",
      "args": ["-y", "@verimand/[email protected]"]
    }
  }
}

请勿在由 Agent 控制的 MCP 工具参数中放入机密、授权信息、Agent DNA、撤销状态或受信任的上下文。生产环境中的 Verimand 连接材料必须由运维人员控制的服务端环境提供，而不能由使用 MCP 客户端的 Agent 提供。

首次权限解析示例

{
  "name": "verimand.resolve",
  "arguments": {
    "agentId": "agent:demo-support",
    "action": "ticket.read",
    "resourceId": "ticket:123",
    "requestId": "req-demo-1"
  }
}

预期的结构化内容包含确定性的权限 decision、原因代码、选定的授权/路径数据；仅当 VAGP 解析结果为 AUTHORITY_CONFIRMED 时，才会包含许可。

安全与信任边界

所有 MCP 输入均不受信任。服务仅接受范围有限的封闭式工具参数，并将其映射到服务端受信任的 VAGP 状态。MCP 调用方不能自行声明受信任的身份、Agent DNA、授权信息、证明、撤销状态或受信任的上下文。

MCP 服务将权限语义交由 VAGP 0.3 权限服务处理。它不会执行受保护的业务操作，也不能替代强制执行网关。受保护工具的执行不属于此软件包的范围。

与 VAGP 的关系

VAGP 0.3 是公开的权限协议：https://github.com/verimand/vagp。此 MCP 服务是 Verimand 提供的接口，用于通过 MCP 检查权限并验证许可。

发布状态

版本 0.1.0 已在 npm 和 MCP Registry 上公开发布。此 MCP 服务所需的 Verimand VAGP 权限运行时已打包到 dist/stdio.js 中；已安装的软件包在运行时不依赖未发布的 @verimand/* 工作区软件包。首次 npm 发布是在未提供来源证明的情况下通过引导方式发布的。未来版本已配置为使用 GitHub OIDC 进行受信任的分阶段发布；这不会追溯性地为 0.1.0 添加来源证明。

开发验证

从干净克隆的仓库开始，使用 Node.js 22 或更高版本：

npm ci
npm run build
npm test
npm run smoke:stdio

公开仓库包含经过审计的打包发行版，不包含私有的 TypeScript 构建源代码。此处的 npm run build 会检查已提交打包文件的语法和存在性；它不会从源代码重新构建打包文件。node:test 测试套件会通过 stdio 启动打包文件，测试全部六个公开工具，检查有限许可和故障关闭场景，并验证重启功能。npm tarball 仍仅限于六个已发布的发行文件。

支持与安全问题报告

请将安全问题发送至 [email protected]。