mcpField
M
mcp-midaz

mcp-midaz

ローカル
github.com/codespar金融データ2755 週間前に更新
リポジトリ

mcp-midaz について

オープンソースの多通貨・多資産複式簿記台帳 Midaz（Lerian 開発）に接続する MCP サーバーです。自社環境で台帳を運用するチーム向けに、エージェントからアカウント、残高、トランザクションを操作できます。

主な機能

  1. 01アカウントの作成とページ単位の一覧取得
  2. 02資産ごとの利用可能残高と保留残高の取得
  3. 03貸借が一致する複式簿記トランザクションの登録
  4. 04操作内容を含むトランザクションの取得
  5. 051 つの接続で複数の台帳を操作

活用シーン

  1. 01セルフホストの Midaz でアカウントを作成し残高を確認する
  2. 02アカウント間の送金を実行し結果を照合する
  3. 03エージェントの支援により社内資金移動を記録する

MCP 対応

MCP クライアントに 5 つのツールを公開する MCP サーバーです。利用者自身の 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 サーバーです。オープンソースのマルチ通貨・マルチアセット対応の複式簿記台帳です。エージェントがアカウントを作成し、残高を読み取り、お客様自身の 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 を明示的に指定するため、1 つの接続で複数の台帳を操作できます。

クイックスタート

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 に移動し、両方の残高を表示してください。」

エージェントは、treasury から借方記入し、@vendor-acme に貸方記入する send ブロックを指定して create_transaction を呼び出します（金額は一致している必要があります。一致しない仕訳は Midaz に拒否されます）。続いて各アカウントで get_balance を呼び出します。

認証

認証方式はお客様のデプロイメントによって決まります。MIDAZ_API_KEY が設定されている場合は Bearer トークンとして送信されます。設定されていない場合、リクエストは認証なしで送信されます（ネットワークから隔離された内部デプロイメントで一般的です）。

エンタープライズ

Midaz 上でエージェント主導の台帳操作にガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT（このサーバー）。Midaz 自体は Lerian による Apache-2.0 です。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。