원장 서비스 MCP 서버

Claude를 통해 원장 파일에 접근하고 관리하기 위한 MCP 서버입니다.

구성 요소

도구

서버는 원장 관리를 위한 세 가지 도구를 구현합니다.

list-accounts : 원장의 모든 계정을 나열합니다.
- "년"을 필수 인수로 사용합니다.
- 사용 가능한 모든 계정의 포맷된 목록을 반환합니다.
account-balance : 특정 계정의 잔액을 가져옵니다.
- 필수 인수로 "year" 및 "account"를 사용합니다.
- 지정된 계정의 현재 잔액을 반환합니다.
account-register : 계좌의 거래 내역을 보여줍니다.
- 필수 인수로 "year" 및 "account"를 사용합니다.
- 지정된 계정에 대한 자세한 거래 내역을 반환합니다.

설치

필수 조건

Python 3.13 이상
uv 패키지 관리자
Node.js와 npm(디버깅용)

PyPI에서 설치

지엑스피1

디버깅

검사기를 사용하여 서버 디버깅:

npx @modelcontextprotocol/inspector \
  uv \
  --directory /path/to/ledger-service \
  run \
  ledger-service

Claude Desktop 구성

Claude Desktop의 구성 파일에 서버 구성을 추가합니다.

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "ledger-service": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/ledger-service",
      "run",
      "ledger-service"
    ]
  }
}

"mcpServers": {
  "ledger-service": {
    "command": "uvx",
    "args": [
      "ledger-service"
    ]
  }
}

개발

로컬 설정

저장소를 복제합니다
가상 환경을 생성하고 활성화합니다
종속성 설치:

기본 경로는 server.py 의 LEDGER_BASE_PATH 상수를 수정하여 구성할 수 있습니다.

특허

GNU 일반 공중 사용 허가서 버전 3, 2007년 6월 29일

Ledger MCP Server