🚀 账本服务 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 常量来配置基础路径。