Mprokopov Ledger MCP Server

🚀 賬本服務 MCP 服務器

賬本服務 MCP 服務器可通過 Claude 對總賬文件進行訪問和管理，為用戶提供便捷的總賬管理功能。

🚀 快速開始

本 MCP 服務器實現了三個實用的總賬管理工具，可幫助用戶高效管理總賬文件。下面為您詳細介紹這些工具：

• 列出賬戶（list-accounts）：該工具可列出總賬中的所有賬戶。使用時需將“年份”作為必填參數傳入，工具會返回格式化後的所有可用賬戶列表。
• 賬戶餘額（account-balance）：用於獲取特定賬戶的當前餘額。此工具要求將“年份”和“賬戶”作為必填參數，之後會返回指定賬戶的當前餘額。
• 賬戶明細（account-register）：可顯示賬戶的交易明細。同樣需要將“年份”和“賬戶”作為必填參數，它會返回指定賬戶的詳細交易歷史記錄。

📦 安裝指南

先決條件

• Python 3.13 或更高版本
• uv 包管理器
• Node.js 和 npm（用於調試）

從 PyPI 安裝

uv pip install ledger-service

💻 使用示例

調試

使用檢查程序來調試服務器：

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

配置 Claude Desktop

將服務器配置添加到 Claude Desktop 的配置文件中：

• 在 MacOS 上：~/Library/Application\ 支持/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"
    ]
  }
}

🔧 技術細節

本地設置

若要進行開發，可按以下步驟進行本地設置：

1. 克隆倉庫
2. 創建並激活虛擬環境
3. 安裝依賴項：可以通過修改 server.py 中的 LEDGER_BASE_PATH 常量來配置基礎路徑。