AI导哈

账本管理服务

通过Claude访问和管理账本文件的服务，提供账户列表查询、账户余额获取和交易记录查看功能。

  • by mprokopov
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 mprokopov/ledger-mcp-server

使用说明

分类帐服务MCP服务器

MCP服务器，用于通过Claude访问和管理分类账文件。

组件

工具

服务器实现了三种分类账管理工具：

  • 列出帐户：列出分类账中的所有账户

    • 将“year”作为必需参数
    • 返回所有可用帐户的格式化列表

  • 账户余额：获取特定帐户的余额

    • 将“year”和“account”作为必需参数
    • 返回指定帐户的当前余额

  • 账户登记簿：显示帐户的交易登记簿

    • 将“year”和“account”作为必需参数
    • 返回指定帐户的详细交易历史记录

安装

先决条件

  • 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桌面

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

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

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

发展

本地设置

  1. 克隆存储库
  2. 创建并激活虚拟环境
  3. 安装依赖项：

可以通过修改来配置基本路径 LEDGER_BASE_PATH 常数in server.py.

许可证

GNU通用公共许可证版本32007年6月29日

相关 MCP