Skip to main content
Glama
deenesjakoruzh
LerianStudio

Lerian MCP Server

by LerianStudio
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Hybrid

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: 공급자, 실행자, 웹훅 및 실행 흐름을 위한 워크플로우 오케스트레이션 플랫폼.

  • 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

일반적인 환경 변수:

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: Node 테스트와 기본 서버 테스트를 실행합니다.

  • npm run docs: docs/에 TypeDoc 출력을 생성합니다.

문서

패키지 정보

  • 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/를 확인하십시오.

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
6dRelease cycle
57Releases (12mo)
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

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/LerianStudio/lerian-mcp-server'

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