mcpField
M
Midaz MCP Server

Midaz MCP Server

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

Midaz MCP Server について

Midaz MCP Serverは、Lerian製品の探索、ドキュメント参照、API確認、設定済み操作の実行をAIアシスタント向けに提供します。製品横断ワークフローにも対応し、変更には明示的な確認と監査理由が必要です。

主な機能

  1. 01製品群とドキュメントの探索
  2. 02学習ガイドとSDKサンプル
  3. 03ライブAPI契約の確認と実行
  4. 04製品横断ワークフローの計画とセッション
  5. 05変更時の確認と監査理由

活用シーン

  1. 01Lerian製品とドキュメントの探索
  2. 02製品APIの学習とSDKサンプル生成
  3. 03設定済み製品APIの確認と呼び出し
  4. 04Fetcher、Reporter、Matcher、Midaz間のワークフロー調整

MCP 対応

stdio経由で、製品群ツール、製品横断ワークフロー、製品別の探索・実行ツールをMCPクライアントに公開します。ライブAPI実行にはエンドポイントと認証情報の設定が必要で、変更には確認と監査理由が求められます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "midaz": {
      "command": "npx",
      "args": [
        "-y",
        "@lerianstudio/lerian-mcp-server"
      ]
    }
  }
}
起動コマンドnpx -y @lerianstudio/lerian-mcp-server

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@lerianstudio/lerian-mcp-server

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Lerian MCP サーバー

Lerian のポートフォリオの探索、ドキュメントの参照、学習、SDK の例、ライブな製品 API へのアクセス、製品横断ワークフローのための MCP ゲートウェイです。

このサーバーは、Claude Desktop、Cursor、Windsurf、Continue、ChatGPT Desktop などの MCP クライアントを Lerian の製品ポートフォリオに接続します。AI アシスタントは、Lerian 製品の探索、公式ドキュメントの参照、実装例の生成、ライブ API コントラクトの確認、設定済み製品 API の実行、複数製品にまたがる運用ワークフローのガイドを、構造化された方法で行えます。

**ランタイムの対象範囲：**このサーバーはドキュメント専用ではありません。統合された lerian ツールは読み取り指向ですが、製品固有の *-execute ツールは、設定済みのライブ Lerian API を呼び出すことができます。API を変更する呼び出しには、明示的な確認と監査理由が必要です。

2 分でセットアップ

  1. MCP 対応の AI アシスタントを選択します。
  2. サーバー設定を追加します。
  3. AI アプリを再起動します。
  4. 「Lerian Midaz について教えてください」と尋ねます。
Claude Desktop

macOS の場所：~/Library/Application Support/Claude/claude_desktop_config.json

Windows の場所：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "lerian": {
      "command": "npx",
      "args": ["-y", "@lerianstudio/lerian-mcp-server@latest"]
    }
  }
}
Cursor、Windsurf、Continue、ChatGPT Desktop

同じ MCP サーバーブロックを、クライアントの MCP 設定に追加します。

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

利用できる機能

対応製品
  • Midaz：統合された複式簿記台帳 — 組織、台帳、アカウント、残高、取引、CRM を単一のサービスで提供します。
  • Fetcher：データソースへの接続、スキーマの検出、非同期抽出サービスを提供します。
  • Reporter：テンプレート駆動のレポート生成、データソース管理、メトリクス、アーティファクトを提供します。
  • Matcher：Midaz の取引と外部システムを照合する照合エンジンです。
  • Tracer：ルール、上限、検証、監査可能性を備えた取引検証エンジンです。
  • Flowker：プロバイダー、エグゼキューター、Webhook、実行フローのためのワークフローオーケストレーションプラットフォームです。
  • Underwriter：ローン商品と返済スケジュールのプレビューを、管轄区域に応じて提供します。
  • All：ポートフォリオ全体の探索、ドキュメント検索、比較を行います。
主な機能
  • operation="discover" を指定した lerian によるポートフォリオの探索。
  • operation="docs" を指定した lerian によるドキュメント検索。
  • operation="learn" を指定した lerian によるガイド付き学習。
  • operation="sdk" を指定した lerian による SDK の例の提供。
  • operation="search" を指定した lerian による製品横断検索。
  • 製品固有の *-discover ツールによるライブ API コントラクトの検出。
  • 製品固有の *-execute ツールによるライブ API の実行。
  • portfolio-workflow による製品横断ワークフロー。
  • オンボーディング、学習、API の利用、運用ワークフローのためのプロンプトベースのガイダンス。

ランタイムのツール構成

このサーバーは、少数のコアツールと、対応する各製品のライブ API ツールペアを公開します。

コアツール
  • lerian：ドキュメント、学習、SDK の例、探索、検索を行う統合ポートフォリオツールです。
  • portfolio-workflow：製品横断ワークフローの探索、計画、状態を保持するセッション、ステップの実行を行います。
ライブ API ツール
  • midaz-discover と midaz-execute
  • fetcher-discover と fetcher-execute
  • reporter-discover と reporter-execute
  • matcher-discover と matcher-execute
  • tracer-discover と tracer-execute
  • flowker-discover と flowker-execute
  • underwriter-discover と underwriter-execute

*-execute ツールを呼び出す前に、対応する *-discover ツールを使用してください。探索結果には、リソース、アクション、パスパラメーター、クエリパラメーター、ボディスキーマ、例、実行時のヒントが含まれます。

lerian ツール

lerian ツールは、読み取りを中心とする主要なエントリーポイントです。

Tool: lerian

Parameters:
  product          midaz | fetcher | reporter | matcher | tracer | flowker | underwriter | all
  operation        discover | docs | learn | sdk | search
  topic            Topic to inspect, learn, or search
  language         go | typescript | javascript, for SDK examples
  useCase          Specific implementation scenario for SDK examples
  experienceLevel  beginner | intermediate | advanced
  format           summary | detailed | examples-only
  includeExamples  true | false
  maxResults       1-50, for search

例：

{
  "product": "midaz",
  "operation": "learn",
  "topic": "transactions",
  "experienceLevel": "beginner"
}

ライブ API ワークフロー

ライブ API へのアクセスは、意図的に 2 段階になっています。

  1. 製品の機能を確認します。
{
  "intent": "list-resources"
}
  1. 特定のアクションの契約を確認します。
{
  "intent": "describe-action",
  "resource": "transactions",
  "action": "create"
}
  1. 検出で返された正確な契約に従って実行します。
{
  "resource": "transactions",
  "action": "create",
  "pathParams": {
    "organizationId": "...",
    "ledgerId": "..."
  },
  "body": {
    "description": "Example transaction"
  },
  "confirmMutation": true,
  "mutationReason": "Create example transaction requested by operator"
}

ライブ API の変更を伴うアクションには、次のものが必要です。

  • confirmMutation: true
  • 人が読める監査理由を記載した mutationReason

製品横断ワークフロー

複数の Lerian 製品にまたがるタスクには、portfolio-workflow を使用します。

現在のワークフロー：

  • fetcher-to-reporter：Fetcher で抽出マッピングを検証してから、Reporter のレポートを生成または確認します。
  • matcher-to-fetcher-to-midaz：Matcher の照合を設定し、Fetcher 経由で Matcher の検出を使用して、Midaz の台帳側のデータを確認します。

サポートされているインテント：

  • list-workflows
  • describe-workflow
  • plan
  • create-session
  • get-session
  • list-sessions
  • execute-step
  • execute-next

ワークフローセッションは、不透明な sessionToken を返します。これは非公開にしてください。

設定

このサーバーは、ドキュメントと検出についてはすぐに動作します。ライブ API の実行には、到達可能な製品サービスと、該当する場合はトークンまたは API キーが必要です。

設定ソースの優先順位は次のとおりです。

  • コマンドラインの --config または --config-file
  • 環境変数
  • ./lerian-mcp-config.json
  • ./midaz-mcp-config.json
  • ~/.lerian/mcp-config.json
  • ~/.midaz/mcp-config.json
  • ~/.config/lerian/mcp-config.json
  • ~/.config/midaz/mcp-config.json
  • プラットフォームのグローバル設定パス

対話形式で設定を作成または更新します。

npx -y -p @lerianstudio/lerian-mcp-server@latest lerian-mcp-config

Midaz は、1 つのベース URL でアクセスする統合台帳サービスです。オンボーディング、アカウント、残高、トランザクション、CRM はすべてその 1 つのサービスのリソースであるため、設定する Midaz の URL は 1 つだけです。

一般的な環境変数：

LERIAN_DOCS_URL=https://docs.lerian.studio
LOG_LEVEL=info

MIDAZ_BASE_URL=http://localhost:3002
MIDAZ_AUTH_TOKEN=...
MIDAZ_API_TIMEOUT=30000

FETCHER_MANAGER_URL=http://localhost:4006
FETCHER_AUTH_TOKEN=...

REPORTER_MANAGER_URL=http://localhost:4005
REPORTER_AUTH_TOKEN=...

MATCHER_BASE_URL=http://localhost:4018
MATCHER_AUTH_TOKEN=...

TRACER_BASE_URL=http://localhost:4020
TRACER_API_KEY=...

FLOWKER_BASE_URL=http://localhost:4021
FLOWKER_AUTH_TOKEN=...
FLOWKER_API_KEY=...

UNDERWRITER_BASE_URL=http://localhost:8080
UNDERWRITER_AUTH_TOKEN=...
4.0.0 への移行

破壊的変更：Midaz の設定。4.0.0 より前のリリースでは、従来の各サービス（オンボーディング、トランザクション、CRM、台帳）につき 1 つ、合計 4 つの Midaz URL が必要でした。これらの変数は廃止されました。読み込まれず、受け付けられません。代わりに、統合された Midaz 台帳を MIDAZ_BASE_URL に設定し、MIDAZ_AUTH_TOKEN はそのまま使用してください。設定にこれ以外の変更はありません。

安全性モデル

  • ライブ実行は、製品固有の *-execute ツールを通じたオプトイン方式です。
  • 変更を伴うメソッドには、明示的な確認と変更理由が必要です。
  • 製品 API のベース URL には http または https を使用する必要があります。
  • localhost 以外の HTTP URL は拒否されます。ローカル開発環境以外では HTTPS が必要です。
  • 認証情報が埋め込まれた URL は拒否されます。
  • 認証ヘッダーと API キーヘッダーは、任意の上書きから保護されます。
  • バイナリーのアップロードとダウンロードのサイズには、設定可能な上限が適用されます。
  • 必要に応じて、シークレットは ~/.lerian/secrets.json にローカルで生成・管理されます。

会話例

ポートフォリオの検出

あなた：「この MCP で対応できる Lerian 製品は何ですか？」

AI：product="all"、operation="discover" を指定して lerian を使用します。

学習パス

あなた：「Tracer を使うのは初めてです。検証ルールの仕組みを教えてください。」

AI：product="tracer"、operation="learn"、topic="rules" を指定して lerian を使用します。

SDK の例

あなた：「Midaz 台帳を作成する Go コードを見せてください。」

AI：product="midaz"、operation="sdk"、language="go" を指定して lerian を使用します。

ライブ API 契約の検出

あなた：「Reporter テンプレートを作成するための契約を確認してください。」

AI：reporter-execute を呼び出す前に reporter-discover を使用します。

製品横断ワークフロー

あなた：「レポートを生成する前に、Fetcher のマッピングを検証する方法を案内してください。」

AI：workflow="fetcher-to-reporter" を指定して portfolio-workflow を使用します。

開発

Node.js >=20.19.0 が必要です。

npm ci
npm run build
npm test

便利なスクリプト：

  • npm run dev：ts-node で TypeScript のエントリーポイントを実行します。
  • npm run build：dist/ にコンパイルし、バイナリを実行可能にします。
  • npm run lint：ESLint を実行します。
  • npm run typecheck：ファイルを出力せずに TypeScript を実行します。
  • npm test：Node のテストと基本的なサーバーテストを実行します。
  • npm run docs：TypeDoc の出力を docs/ に生成します。

ドキュメント

パッケージ情報

アーキテクチャの概要

MCP Client
  -> stdio transport
  -> MCP server runtime
  -> core tools and prompts
  -> product adapters
  -> product routers and schema registries
  -> configured Lerian product APIs

主なレイヤー：

  1. トランスポート： stdio 経由の MCP JSON-RPC。
  2. サーバーのブートストラップ： セキュリティ、シークレット、ドキュメントマニフェスト、ロギング、クライアント検出。
  3. コアツール： lerian と portfolio-workflow。
  4. プロダクトアダプター： 対応するプロダクトの検出／実行ペア。
  5. スキーマレジストリ： API サーフェスのリソース／アクションの契約。
  6. HTTP 実行： URL の検証と構築、リクエストの実行、レスポンスの解析、エラーの分類。
  7. ワークフローのオーケストレーション： ガイド付きのステートフルな複数プロダクトのフロー。

トラブルシューティング

サーバーが起動しない

Node.js のバージョンを確認します：

node --version

手動で実行します：

npx -y @lerianstudio/lerian-mcp-server@latest

ローカルのシークレットを確認します：

ls -la ~/.lerian/secrets.json
ライブ API 呼び出しが失敗する
  • まずプロダクトの *-discover ツールを使用してください。
  • 関連するベース URL とトークン／API キーが設定されていることを確認してください。
  • ローカルではないリモート URL には HTTPS が使用されていることを確認してください。
  • 変更を行う場合は、confirmMutation=true と mutationReason を指定してください。
  • MCP ランタイムから対象のプロダクトサービスに到達できることを確認してください。
クライアントでツールが応答しない
  • 設定を変更した後、MCP クライアントを再起動してください。
  • クライアントで MCP が有効になっていることを確認してください。
  • 必要に応じて LOG_LEVEL=debug でロギングを有効にしてください。
  • ロギングが有効な場合は、./logs/ を確認してください。

コメント

Markdown 対応

MCP は初めてですか？

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

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