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"]
    }
  }
}

Related MCP server: DevDocs MCP Server

提供機能

サポートされている製品

• 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"
}

2. 特定のアクションコントラクトを検査する:

{
  "intent": "describe-action",
  "resource": "transactions",
  "action": "create"
}

3. 探索によって返された正確なコントラクトを使用して実行する:

{
  "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

一般的な環境変数:

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

MIDAZ_ONBOARDING_URL=http://localhost:3000
MIDAZ_TRANSACTION_URL=http://localhost:3001
MIDAZ_CRM_URL=http://localhost:3002
MIDAZ_LEDGER_URL=http://localhost:3003
MIDAZ_AUTH_TOKEN=...

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=...

安全性モデル

• ライブ実行は、製品固有の *-execute ツールを通じてオプトインされます。

• 変更を伴うメソッドには、明示的な確認と変更理由が必要です。

• 製品APIのベースURLは http または https を使用する必要があります。

• ローカルホスト以外の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: ノードテストと基本的なサーバーテストを実行します。

• npm run docs: docs/ にTypeDoc出力を生成します。

ドキュメント

• 完全なドキュメント

• 学習パス

• SDKリファレンス

• トラブルシューティング

• メディアおよび図のインデックス

• エージェント向け指示

パッケージ情報

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

• 現在のパッケージバージョン: 3.4.0

• ランタイム: Node.js ESM

• MCP SDK: @modelcontextprotocol/sdk

• ライセンス: Apache-2.0

• リポジトリ: github.com/lerianstudio/lerian-mcp-server

アーキテクチャの概要

MCP Client
  -> stdio transport
  -> McpServer from @modelcontextprotocol/sdk
  -> 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/ を確認してください。