mcpField
M
mcp-midaz

mcp-midaz

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-midaz

MCP 服务，用于操作开源的多币种、多资产复式记账账本 Midaz（由 Lerian 开发）。它面向需要在自有部署中管理账户、余额和交易的团队，可由 Agent 直接执行记账操作。

主要功能

  1. 01账户创建与分页列表
  2. 02按资产查询可用与冻结余额
  3. 03发布平衡的复式记账交易
  4. 04按 ID 查询交易及其明细
  5. 05支持跨多个账本操作

适用场景

  1. 01在自托管的 Midaz 中创建账户并查询余额
  2. 02在账户之间转账并核对结果
  3. 03由 Agent 辅助记录内部资金划转

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 5 个工具，用于在用户自有的 Midaz 部署中创建账户、读取余额和提交交易。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-midaz": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-midaz"
      ],
      "env": {
        "MIDAZ_BASE_URL": "<MIDAZ_BASE_URL>",
        "MIDAZ_TRANSACTION_URL": "<MIDAZ_TRANSACTION_URL>",
        "MIDAZ_API_KEY": "<MIDAZ_API_KEY>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-midaz
需要配置的环境变量
MIDAZ_BASE_URLBase URL of your self-hosted Midaz onboarding service
MIDAZ_TRANSACTION_URLBase URL of the Midaz transaction service. Defaults to MIDAZ_BASE_URL.
MIDAZ_API_KEY密钥Bearer token when your deployment enforces auth

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

安装包
npm@codespar/mcp-midaz0.1.0

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
namestring是账户显示名称
typestring是账户类型（例如 deposit、savings、creditCard、expense）
aliasstring否可选的唯一别名（在交易操作中用作 @alias）
extraobject否任何其他 Midaz 账户字段，合并到负载中
ledger_idstring是组织内的账本 ID
asset_codestring是账户持有的资产（例如 BRL、USD）
organization_idstring是Midaz 组织 ID

详细介绍

@codespar/mcp-midaz

由 Lerian 提供的 Midaz MCP 服务——这是一款开源、多币种、多资产的复式记账账本。你的 Agent 可以在你自己的 Midaz 部署上创建账户、读取余额并提交借贷平衡的交易。

npm License: MIT

可自托管模式

Midaz 不是 SaaS——它运行在你的基础设施中（github.com/LerianStudio/midaz）。此服务连接到你的部署：

  • MIDAZ_BASE_URL → 你的开户服务（组织 / 账本 / 账户）
  • MIDAZ_TRANSACTION_URL → 你的交易服务（当两个服务位于同一网关后时，默认使用 MIDAZ_BASE_URL）
  • MIDAZ_API_KEY → 仅在你的部署强制要求身份验证时使用

Midaz 层级结构：组织 → 账本 → 账户 → 交易。工具会明确接收 organization_id + ledger_id，因此一个连接即可跨账本操作。

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "midaz": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-midaz"],
      "env": {
        "MIDAZ_BASE_URL": "https://midaz.your-company.internal",
        "MIDAZ_API_KEY": "your-token-if-any"
      }
    }
  }
}
Claude Code
claude mcp add midaz -- npx @codespar/mcp-midaz

工具（5 个）

工具功能
create_account在账本中创建账户（POST .../accounts）
list_accounts分页列出账本中的账户
get_balance读取每种资产的可用余额 / 冻结余额
create_transaction提交借贷平衡的复式交易（POST .../transactions/json）
get_transaction获取交易及其操作

示例

“将 R$ 1.250,00 从资金账户转到 @vendor-acme，并显示两个账户的余额。”

Agent 会调用 create_transaction，通过 send 块从 treasury 扣款并向 @vendor-acme 入账（金额必须平衡——Midaz 会拒绝不平衡的分录），然后对每个账户调用 get_balance。

身份验证

由你的部署决定：设置 MIDAZ_API_KEY 时，该密钥会作为 Bearer 令牌发送；否则请求不经过身份验证（这通常适用于通过网络隔离的内部部署）。

企业版

需要为由 Agent 驱动的 Midaz 账本操作提供治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、支付路由和合规模板。

许可证

MIT（本服务）。Midaz 本身由 Lerian 采用 Apache-2.0 许可证发布。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。