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

💻 使用示例

基础用法

以下是使用 list - accounts 工具列出 2024 年所有账户的示例：

# 列出 2024 年所有账户
uv run list-accounts --year 2024

高级用法

以下是使用 account - register 工具查看 2024 年“储蓄账户”交易明细的示例：

# 查看 2024 年储蓄账户的交易明细
uv run account-register --year 2024 --account "储蓄账户"

📚 详细文档

调试

使用检查程序来调试服务器：

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

配置 Claude 桌面

将服务器配置添加到 Claude 桌面的配置文件中：

• 在 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"
    ]
  }
}

开发

本地设置

1. 克隆仓库
2. 创建并激活虚拟环境
3. 安装依赖：可以通过修改 server.py 中的 LEDGER_BASE_PATH 常量来配置基路径。