关于 agent-spend-policy-mcp
agent-spend-policy-mcp 是本地 MCP 服务,可按给定策略确定性地检查 Agent 拟议支出操作。它返回判定和稳定的原因代码,不处理支付,也不发起网络请求。
主要功能
- 01按给定策略评估操作
- 02返回 ELIGIBLE、DENY 或 STEP_UP
- 03提供稳定的原因代码
- 04以整数微单位字符串传入金额
- 05不产生副作用或网络请求
适用场景
- 01对 Agent 拟议支出操作进行试运行
- 02检查操作是否符合本地策略
- 03为支出判定生成本地依据
MCP 相关
通过本地 stdio MCP 暴露 `evaluate_spend_policy` 工具。它仅返回策略评估结果,不支持支付授权或执行。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
1收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | object | 是 | |
| action.rail | any | 是 | |
| action.asset | any | 是 | |
| action.agentId | any | 是 | |
| action.purpose | string | 否 | |
| action.expiresAt | string | 是 | |
| action.recipient | any | 是 | |
| action.authorityId | any | 是 | |
| action.payloadHash | any | 是 | |
| action.principalId | any | 是 | |
| action.amountMicros | any | 是 | |
| action.idempotencyKey | any | 是 | |
| policy | object | 是 | |
| policy.allowedRails | array | 是 | |
| policy.expectedAsset | any | 是 | |
| policy.maxDailyMicros | any | 是 | |
| policy.requirePurpose | boolean | 否 | |
| policy.stepUpAtMicros | any | 否 | |
| policy.expectedAgentId | any | 是 | |
| policy.allowedRecipients | array | 是 | |
| policy.maxPerActionMicros | string | 是 | |
| policy.expectedAuthorityId | any | 是 | |
| policy.expectedPayloadHash | any | 是 | |
| policy.expectedPrincipalId | string | 是 | |
| policy.expectedIdempotencyKey | any | 是 | |
| evaluationTime | string | 是 | |
| alreadySpentMicros | any | 是 |
详细介绍
DingDawg Agent 支出策略 MCP
一个小型本地 MCP 服务,可确定性地评估拟议的 Agent 支出操作是否符合给定策略。
它会返回 ELIGIBLE、DENY 或 STEP_UP,并附带稳定的原因代码。
ELIGIBLE 仅表示本地策略证据,不代表支付授权。
安全边界
此软件包不持有资金、私钥、支付凭证、客户数据或结算权限。它不会签署、发送、结算、托管或记录支付,也不会发起网络请求。
生产环境中的支付适配器需要采用单独且经过独立验证的控制措施,以验证策略/操作来源、规范载荷哈希、持久化原子预算预留与重放保护、由客户控制的签名、支付通道验证和结算对账。
安装
npx -y @dingdawg/agent-spend-policy-mcp
将其配置为本地 stdio MCP 服务:
{
"mcpServers": {
"dingdawg-agent-spend-policy": {
"command": "npx",
"args": ["-y", "@dingdawg/agent-spend-policy-mcp"]
}
}
}
工具
evaluate_spend_policy 接受评估时间、策略、拟议操作以及已支出的金额。所有金额均以整数微单位字符串传递,绝不使用 JavaScript 浮点数。
调用方提供时钟和已支出金额;因此,此工具适用于试运行和本地证据,但不能替代可信的支付或会计系统。
Agent 合约
带版本的机器可读合约位于
capabilities.json。它描述了此软件包公开的唯一工具、必需的输入、三种可能的结果以及不可妥协的安全边界。
- 传输方式:本地 stdio MCP
- 工具:
evaluate_spend_policy - 必需输入:
evaluationTime、policy、action和alreadySpentMicros - 输出:
ELIGIBLE、DENY或STEP_UP,每种结果都带有稳定的原因代码 - 副作用:无
- 凭证、支付执行、托管、签名、结算和网络访问:不支持
此清单是本次发布的软件包源码证据,并不承诺提供托管式 Agent 发现端点。ELIGIBLE 仍仅表示本地策略证据,不代表支付授权。
开发
npm install
npm test
npm run pack:check
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。