local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Used to set the LEDGER_FILE environment variable for configuring the path to the user's ledger file

mcp-server-ledger: Ledger CLI MCP 서버

개요

명령줄에서 접근 가능한 강력한 복식부기 회계 시스템인 Ledger CLI 와 상호 작용하기 위한 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 대규모 언어 모델(Large Language Models)이 Ledger CLI 도구를 통해 재무 데이터를 쿼리하고 분석할 수 있습니다.

이 MCP 서버는 표준화된 인터페이스를 통해 Ledger CLI의 기능을 제공하여 AI 도우미가 재무 보고, 예산 분석, 회계 업무를 쉽게 도울 수 있도록 합니다.

특징

서버는 Ledger CLI 명령에 매핑되는 다음 도구를 제공합니다.

ledger_balance
- 강력한 필터링 옵션을 사용하여 계정 잔액을 표시합니다.
- 입력: 쿼리 패턴, 날짜 범위, 표시 옵션
- 반환: 서식이 지정된 잔액 보고서
ledger_register
- 자세한 내역을 포함한 거래 내역을 보여줍니다.
- 입력: 쿼리 패턴, 날짜 범위, 정렬 옵션
- 반환: 형식화된 등록 보고서
ledger_accounts
- 원장 파일의 모든 계정을 나열합니다
- 입력: 선택적 쿼리 패턴
- 반환: 일치하는 계정 목록
ledger_payees
- 거래의 모든 수취인을 나열합니다.
- 입력: 선택적 쿼리 패턴
- 반환: 일치하는 수취인 목록
ledger_commodities
- 사용되는 모든 상품(통화)을 나열합니다.
- 입력: 선택적 쿼리 패턴
- 반품: 일치하는 상품 목록
ledger_print
- 원장 형식으로 거래를 인쇄합니다.
- 입력: 쿼리 패턴, 날짜 범위
- 반환: 서식이 지정된 원장 항목
ledger_stats
- 원장 파일에 대한 통계를 보여줍니다
- 입력: 선택적 쿼리 패턴
- 반환: 원장의 통계 요약
ledger_budget
- 예산 분석을 보여줍니다
- 입력: 쿼리 패턴, 날짜 범위, 보고 기간
- 반환: 예산 보고서
ledger_raw_command
- 원시 Ledger CLI 명령을 실행합니다.
- 입력: 문자열 목록 형태의 명령 인수
- 반환: 명령 출력을 텍스트로 출력

필수 조건

Ledger CLI가 설치되어 PATH에 사용 가능해야 합니다.
재무 데이터가 포함된 유효한 원장 파일

설치

uv 사용(권장)

이 서버를 설치하고 실행하는 가장 쉬운 방법은 uv를 사용하는 것입니다.

지엑스피1

구성

서버에 Ledger 파일 경로가 필요합니다. 다음을 통해 제공할 수 있습니다.

LEDGER_FILE 환경 변수
서버를 시작할 때의 명령줄 인수

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

"mcpServers": {
  "ledger": {
    "command": "uv",
    "args": [
      "run",
      "--env-file",
      "/path/to/your/.env",  // Optional: to set LEDGER_FILE
      "--with",
      "mcp[cli]",
      "mcp",
      "run",
      "<repo_path>/main.py"  // Path to the main.py file in this repository
    ]
  }

}

사용 예

구성이 완료되면 AI 비서에게 재무 데이터에 대한 질문을 할 수 있습니다.

"지난 달 지출 보여줘"
"현재 모든 계좌의 잔액은 얼마입니까?"
"Amazon과의 모든 거래 내역을 나열하세요"
"2023년에 식료품에 얼마를 썼나요?"
"1분기 예산 실적 보여주세요"

AI는 서버를 통해 적절한 Ledger CLI 명령을 사용하여 정보를 가져옵니다.

디버깅

더 자세한 현지 테스트를 원하시면:

mcp dev main.py

개발

이 서버는 Model Context Protocol Python SDK를 사용하여 구축되었습니다. MCP 및 MCP 서버 개발 방법에 대한 자세한 내용은 공식 문서를 참조하세요.

이 프로젝트에 기여하려면:

저장소를 복제합니다
개발 종속성 설치
변경 사항을 만드세요
MCP 검사기를 사용하거나 Claude Desktop과 통합하여 테스트합니다.

보안 고려 사항

이 서버는 재무 데이터에 Ledger CLI 명령을 실행합니다. 명령 삽입을 방지하기 위한 기본적인 검증 기능이 포함되어 있지만, 다음 사항을 준수해야 합니다.

신뢰할 수 있는 클라이언트에게만 사용하세요
어떤 파일 경로를 노출하는지 주의하세요
실행하기 전에 모든 명령을 검토하세요

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 라이선스 조건에 따라 자유롭게 사용, 수정 및 배포할 수 있습니다.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Ledger CLI를 통해 AI 보조자가 재무 데이터를 쿼리하고 분석하여 재무 보고, 예산 분석, 회계 등의 작업을 수행할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

Ledger CLI MCP Server