Cedulon

Name: Cedulon
Author: dogrucanemek-alt

本地服务

cedulon.com金融数据13 天前更新

代码仓库访问官网

关于 Cedulon

Cedulon 是本地 stdio MCP 服务，用于按策略控制支出、验证收据并核对账本。它适用于需要可审计支出决策的 Agent 工作流，使用进程内模拟支付通道，不连接钱包或网络。

主要功能

01按策略限制支出请求
02为获准支出签发签名收据
03将收据与支付通道提取记录核对
04验证收据 COSE 数据和签名
05导出账本及审计结果
06查看策略和账本状态

适用场景

01按金额和收款方限制 Agent 付款
02将收据与结算记录核对
03验证收据及其附加签名
04导出可审计的账本快照

MCP 相关

向 MCP 客户端提供支出、审计、收据验证、账本导出和状态工具。本地服务使用进程内模拟支付通道，并通过 stdio 通信。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dogrucanemek-alt-cedulon": {
      "command": "npx",
      "args": [
        "-y",
        "@cedulon/mcp-server"
      ],
      "env": {
        "CEDULON_STATE_PATH": "<CEDULON_STATE_PATH>",
        "CEDULON_MAX_AMOUNT": "<CEDULON_MAX_AMOUNT>",
        "CEDULON_MAX_CUMULATIVE": "<CEDULON_MAX_CUMULATIVE>",
        "CEDULON_MAX_PAYMENTS": "<CEDULON_MAX_PAYMENTS>"
      }
    }
  }
}

启动命令npx -y @cedulon/mcp-server

需要配置的环境变量

CEDULON_STATE_PATHOptional JSON file that persists the in-process ledger

CEDULON_MAX_AMOUNTPer-payment amount cap (demo default 10)

CEDULON_MAX_CUMULATIVEWindow cumulative cap (demo default 30)

CEDULON_MAX_PAYMENTSWindow payment-count cap (demo default 3)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@cedulon/mcp-server0.16.0stdio

工具

收录的工具列表 · 更新于 3 天前

参数	类型	必填	说明
tool	string	否	请求中记录的调用工具名称
nonce	string	是
payee	string	是
amount	string	是	以十进制字符串表示的整数金额
currency	string	是

详细介绍

`@cedulon/mcp-server`

本地 stdio MCP 服务。对 @cedulon/core、 @cedulon/x402-adapter、@cedulon/audit 和 @cedulon/receipts 进行轻量封装。唯一的非工作区运行时依赖是官方 MCP SDK。

核心软件包仍然不含任何运行时依赖。本软件包仅依赖这些工作区软件包以及 @modelcontextprotocol/sdk。

工具

名称	功能
`cedulon_spend`	由策略控制的支出。参数：`amount`、`currency`、`payee`、`nonce`、`tool`。允许 → 已签名的收据 JSON。拒绝 → `{ ok: false, reason }`。
`cedulon_audit`	根据支付轨道提取数据核对收据链：使用进程内账本，或使用你通过 `extract` 提供的已签名提取数据。可选的 `extraSettlements` 会注入提取数据行（绕过演示；与 `extract` 同时使用时会被拒绝）。如果核对时使用了提供的提取数据，结果会包含 `scope`；还会包含 `counts`，用于说明每张收据和每一行归入的类别。
`cedulon_verify_receipt`	验证收据 COSE 字节（`receipt` 对象，或 `coseHex` + `publicKeyPem`）。如果存在反签名，也会进行检查。
`cedulon_export_ledger`	以 `demo:export` JSON 格式导出收据、检查点和提取数据，并附上对本服务自身账本进行核对所得的发现、保证和 `counts`。
`cedulon_status`	版本、策略摘要、收据数量、链头。

运行

二进制文件为 cedulon-mcp（编译后的 JavaScript，无需 --experimental-strip-types）。在本仓库中，运行 npm run build:packages 后：

node packages/mcp-server/dist/index.js

使用已发布的软件包，无需克隆：

npx -y @cedulon/mcp-server

npx cedulon-mcp 可从打包或已安装的副本运行同一个二进制文件。该服务也已在 MCP Registry 中登记为 io.github.dogrucanemek-alt/cedulon。

从仓库源代码目录运行（开发模式）：

npm run mcp

主机配置

安装软件包后，可用于 Claude Desktop / Claude Code / Cursor（mcpServers）：

{
  "mcpServers": {
    "cedulon": {
      "command": "npx",
      "args": ["-y", "@cedulon/mcp-server"]
    }
  }
}

状态和策略

默认使用进程内状态。将 CEDULON_STATE_PATH 设为 JSON 文件，即可在进程重启后保留收据、检查点、提取数据行和演示密钥。请勿提交此文件。

策略参数（括号内为演示默认值）：

CEDULON_MAX_AMOUNT（10）
CEDULON_MAX_CUMULATIVE（30）
CEDULON_MAX_PAYMENTS（3）
CEDULON_WINDOW_MS（3600000）
CEDULON_ALLOWED_PAYEES（payee-1；* 会清空列表）
CEDULON_ALLOWED_CURRENCIES（USD；* 会清空列表）
CEDULON_ALLOWED_TOOLS
CEDULON_PAYER（payer-1）

支付轨道是进程内模拟器。不使用钱包、RPC 或网络。

隐私政策

https://cedulon.com/privacy.html

以下是该页面详细说明的简要版本。本服务在你的计算机上运行，并通过 stdio 与客户端通信。它不会发出网络请求：本软件包及其依赖的六个软件包不包含 HTTP 客户端、套接字或遥测功能；唯一的项目外依赖是官方 Model Context Protocol SDK。它不会收集任何信息，因为我们没有用于收集信息的端点。

运行期间，它会在内存中保存本次会话的支出请求（金额、货币、收款方、随机数、调用工具名称）、据此生成的收据、检查点以及你的策略限制。除非你设置 CEDULON_STATE_PATH，否则不会向磁盘写入任何内容；如果设置了该变量，账本会以 JSON 格式写入你在本机选择的路径。不进行分析、不报告崩溃、不检查更新，也不与第三方共享数据。

隐私问题和安全报告：[email protected]。

支持 Markdown

登录后评论