Skip to main content
Glama
deenesjakoruzh
BenyFridY

mesa-mcp

by BenyFridY
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

tercet

机器支付的权威账本。 每一笔代理购买都会在其发生时被记录（请求 → 报价 → 签名授权），与链上结算进行对账，并且每一个差异都有一个名字——已交付未收款、已付款未交付、重放、链孤儿。tercet 从不触碰密钥、余额或支付路径：它观察并产出证据。

tercet 是一种三行诗节，三行彼此相属——在此，每一笔购买就是一个三行诗节：请求、授权、结算。但丁把他的三行诗节联缀起来，抽出任何一行都会使整首诗断裂；这本账本也用同样的方式将其条目环环相扣。

Python 包目前仍名为 mesa（工作名）；将在首次 PyPI 发布时更名为 tercet。docs/ 下的项目文档用葡萄牙语撰写——它们是构建日记和各阶段设计文档；代码、数据模式和本 README 均为英文。

应用——账本，实时，六个屏幕

uv run mesa-app        # -> http://127.0.0.1:8400

01 交易明细账（你的代理购买了什么，包含衍生状态和每笔购买的事件链）· 02 tca（损耗、跨代理去重、每个交付结果的成本）· 03 风险（每个任务树的预算、人员审批、付款人护照）· 04 实验（保持透明置信区间的时间点支出策略回测）· 05 账目（三方对账、两个第三方时间戳的封存期间、每家交易对手报表、巴西税务视图）· 06 运维（从屏幕上运行经审计的各引擎——演示、采集器、导出——仅测试网）。

该应用在结构上为只读：其 Postgres 会话以 default_transaction_read_only=on 打开，因此即使它想写入账本也无法写入——tests/test_app.py 证明了这一点。真实数据始终如此；测试网和合成行会在屏幕本身上打上标签。按代码块即可查看其图例。

Related MCP server: swarm-at

MCP 服务器 —— 面向代理的账本工具

claude mcp add tercet -- uv run mesa-mcp    # then ask: "how much did my agents spend?"

七个 READ 工具（封闭清单，已验证）：status_do_livro、gasto、compras（可按条件过滤）、compra（一笔购买及其事件链）、vereditos、passaportes、fiscal。与应用相同的保证：会话在结构上为只读——MCP 服务器没有写入路径；tests/test_mcp_livro.py 证明了这一点。传输方式：stdio，本地。

导出 —— 全覆盖会计 + OECD CARF 视图

uv run python scripts/fase13/contabil_build.py   # -> contabil/<yyyy-mm>/  (universal CSV, QuickBooks, Xero + per-tx audit detail)
uv run python scripts/fase13/carf_build.py       # -> fiscal/carf/<year>/  (OECD CARF view, born as OECD11 test data)

每个时期的复式记账（``、book-keeping（已证明每个条目贷方 == 借方；微支付被非诚实聚合，并通过 6 位小数审计桥梁将每一分钱关联到各自的交易哈希）以及 CARF 视图——根据 OECD 框架（2025 年官方指南）将报告这些交易的声明性加密资产服务提供商的内容——标记为演示、合成身份、真实金额。详情和注意事项见：docs/fase13-export.md。

仅凭本 README 的一切

前提条件：uv、Docker、Python 3.11+。

# 1. dependencies + database (Postgres 17 on 127.0.0.1:5433 — your machine only)
uv sync
docker run -d --name mesa-pg -e POSTGRES_USER=mesa -e POSTGRES_PASSWORD=mesa `
  -e POSTGRES_DB=mesa -p 127.0.0.1:5433:5432 `
  -v mesa-pgdata:/var/lib/postgresql/data postgres:17
uv run python scripts/check_db.py            # migrations + hash-chain genesis, idempotent

# 2. TEST wallets (written to a local .env; never committed) + faucet USDC
uv run python scripts/setup_wallets.py
#    -> paste the buyer address into https://faucet.circle.com (USDC / Base Sepolia)
uv run python scripts/check_balance.py       # balance read on-chain

# 3. a toy seller + 10 REAL x402 payments on testnet
uv run uvicorn mesa.http.seller:app --port 8402     # terminal 1
uv run python scripts/fase1/buyer.py 10             # terminal 2 (writes the ledger)

# 4. the chain is the source of truth: collect and reconcile
uv run python -m mesa.collector              # matches (authorizer, nonce) with the ledger
uv run python -m mesa.cli                    # the verdict table, orphans in red

# 5. the product
uv run mesa-app                              # -> http://127.0.0.1:8400

成本为零真实资金：走水龙头领取 USDC，且在 exact 方案下，facilitator 承担 gas 费。

  • 发生了什么、证明什么、接下来是什么： 构建日志（docs/DIARIO.md）；按阶段的设计文档见 docs/faseN.md。

  • 密钥（setup_wallets.py 生成的私钥）存放于本地 .env（stu 已 gitignore，绝不提交）。要保存在别处，请将 MESA_ENV_FILE 指向相应文件——并避免它进入同步文件夹（OneDrive/Dropbox）：位于同步文件夹中的私密文件等同位于云端。

仓库地图

路径

说明

src/mesa/config.py

常量（USDC、网络、链 ID）+ 从 .env 读取的 Settings

src/mesa/db.py

账本访问——结构上只写入

src/mesa/reconcile.py

核心：三方对账，纯函数

src/mesa/collector.py

链上采集器：每个 txHash 的 Transfer + AuthorizationUsed；幂等、持久游标

src/mesa/cli.py

uv run python -m mesa.cli —— 结论表，孤儿条目以红色显示

src/mesa/http/

HTTP 轨道：玩具代币（带 chaos 模式）+ 有状态读数

src/mesa/mcp/

MCP 轨道：付费工具（消费者/礼仪规则）+ livro.py，只读成品 MCP 服务器

src/mesa/app/

Web 应用（FastAPI + Jinja2，服务端渲染，只读会话）

src/mesa/passaporte.py

付款人护照：可分发的自签名结算历史

src/mesa/contabil.py / carf.py / decripto.py

导出渲染器（复式记账 / OECD CARF / 巴西税务）

migrations/

带编号的纯 SQL——与轨道和传输无关的 schema

scripts/

环境工具 + faseN/——每阶段的可执行证明

tests/

作为 pytest 的门禁：脏数据进 → 期望的有害输出

docs/

构建日志 + 分阶段设计文档（葡萄牙语）

verificador/

独立验证器——在不信任本仓库的情况下检查账本和付款人护照

环境

uv sync
docker run -d --name mesa-pg -e POSTGRES_USER=mesa -e POSTGRES_PASSWORD=mesa `
  -e POSTGRES_DB=mesa -p 127.0.0.1:5433:5432 `
  -v mesa-pgdata:/var/lib/postgresql/data postgres:17
# 127.0.0.1 is mandatory: without it the ledger is open to any machine on the same
# Wi-Fi (docs/seguranca.md, hole #1). scripts/saude.py checks this, always.
uv run python scripts/setup_wallets.py   # generates the EOAs -> .env (NEVER committed)
uv run python scripts/check_db.py        # Postgres up + migrations + genesis
uv run python scripts/check_balance.py   # USDC balance read on-chain
uv run python scripts/saude.py           # ONE command: ruff+mypy+pytest+verifier+ports+secret scan
uv run python scripts/backup_db.py       # ledger dump -> backups/ (routine, ~5s)

水龙头：https://faucet.circle.com → USDC → Base Sepolia（每个地址 20 USDC）。Anthropic 密钥（仅供开发用途的发票轨道 agent 演示）：ANTHROPIC_API_KEY=...，放入明文文件中。

运行各阶段的注册表

# Phase 1 — the ledger closes on dirty data
uv run uvicorn mesa.http.seller:app --port 8402     # terminal 1: HTTP seller
uv run python scripts/fase1/chaos_run.py            # terminal 2: chaos + reconciliation + asserts

# Phase 2 — x402 over MCP
uv run python -m mesa.mcp.seller                    # terminal 1: MCP seller (port 8403)
uv run python scripts/fase2/mcp_once.py             # terminal 2: 1 paid tool call + ledger

# Phase 10 — the payer passport (emits, verifies, gates a seller)
uv run python scripts/fase10/gate10_demo.py

# Any time: sweep the chain and reconcile
uv run python -m mesa.collector                      # testnet (seller payTo)
uv run python -m mesa.collector --pagador            # mainnet (payer-side)
uv run python -m mesa.cli

质量（"完成" 有明确定义）

uv run python scripts/saude.py    # ONE command: ruff+mypy+pytest+verifier+ports+secret scan

威胁模型，以及明确不在范围之列的内容：docs/seguranca.md。

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • AgentBodega MCP by agentbodegastore

    AgentBodega MCPofficial

    agentbodegastore
    A
    license
    A
    quality
    D
    maintenance
    Enables agents to search and inspect live service offerings, generate x402 payment snippets, and understand blockchain-only balance policies.
    4
    96
    1
    MIT

  • swarm-at

    Mediaeater
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables agent settlement, trust verification, and ledger operations for multi-agent workflows, with tools for blueprint management, credit tracking, and provenance recording.
    1
    MIT

  • mcp-ledger-server

    grzegorzkowalskigk-jpg
    F
    license
    A
    quality
    B
    maintenance
    Exposes a ledger system (invoice queue, duplicate control, VAT register, contractor history, decision journal) as MCP tools for AI agents, enabling accurate invoice processing with deterministic validation.
    7

View all related MCP servers

Related MCP Connectors

  • VouchSpec Agent Skill Evidence

    Read-only discovery for exact-commit Agent Skill validation, x402 payment, and signed receipts.

  • Financial Evidence

    Read-only public financial evidence from LiquiLens, Undertow, Seiche and Palimpsest.

  • HiveEcho

    Immutable event logging and audit trail for agent transactions

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/BenyFridY/tercet'

If you have feedback or need assistance with the MCP directory API, please join our Discord server