mcp-server-ledger: Ledger CLI MCP 서버

개요

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

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

Related MCP server: Moneybird MCP Server

특징

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

1. ledger_balance

   • 강력한 필터링 옵션을 사용하여 계정 잔액을 표시합니다.

   • 입력: 쿼리 패턴, 날짜 범위, 표시 옵션

   • 반환: 서식이 지정된 잔액 보고서

2. ledger_register

   • 자세한 내역을 포함한 거래 내역을 보여줍니다.

   • 입력: 쿼리 패턴, 날짜 범위, 정렬 옵션

   • 반환: 형식화된 등록 보고서

3. ledger_accounts

   • 원장 파일의 모든 계정을 나열합니다

   • 입력: 선택적 쿼리 패턴

   • 반환: 일치하는 계정 목록

4. ledger_payees

   • 거래의 모든 수취인을 나열합니다.

   • 입력: 선택적 쿼리 패턴

   • 반환: 일치하는 수취인 목록

5. ledger_commodities

   • 사용되는 모든 상품(통화)을 나열합니다.

   • 입력: 선택적 쿼리 패턴

   • 반품: 일치하는 상품 목록

6. ledger_print

   • 원장 형식으로 거래를 인쇄합니다.

   • 입력: 쿼리 패턴, 날짜 범위

   • 반환: 서식이 지정된 원장 항목

7. ledger_stats

   • 원장 파일에 대한 통계를 보여줍니다

   • 입력: 선택적 쿼리 패턴

   • 반환: 원장의 통계 요약

8. ledger_budget

   • 예산 분석을 보여줍니다

   • 입력: 쿼리 패턴, 날짜 범위, 보고 기간

   • 반환: 예산 보고서

9. ledger_raw_command

   • 원시 Ledger CLI 명령을 실행합니다.

   • 입력: 문자열 목록 형태의 명령 인수

   • 반환: 명령 출력을 텍스트로 출력

필수 조건

• Ledger CLI가 설치되어 PATH에 사용 가능해야 합니다.

• 재무 데이터가 포함된 유효한 원장 파일

설치

uv 사용(권장)

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

지엑스피1

구성

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

• LEDGER_FILE 환경 변수

• 서버를 시작할 때의 명령줄 인수

Claude Desktop과 함께 사용

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

사용 예

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

• "지난 달 지출 보여줘"

• "현재 모든 계좌의 잔액은 얼마입니까?"

• "Amazon과의 모든 거래 내역을 나열하세요"

• "2023년에 식료품에 얼마를 썼나요?"

• "1분기 예산 실적 보여주세요"

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

디버깅

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

개발

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

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

1. 저장소를 복제합니다

2. 개발 종속성 설치

3. 변경 사항을 만드세요

4. MCP 검사기를 사용하거나 Claude Desktop과 통합하여 테스트합니다.

보안 고려 사항

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

• 신뢰할 수 있는 클라이언트에게만 사용하세요

• 어떤 파일 경로를 노출하는지 주의하세요

• 실행하기 전에 모든 명령을 검토하세요

특허

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