Spendlog

Name: Spendlog
Author: makz81

本地服务

github.com/makz81金融数据121 周前更新

代码仓库

关于 Spendlog

Spendlog 是面向个体经营者的本地化业务开支与发票追踪 MCP 服务，可在 Claude 等环境中通过自然语言管理财务记录。数据保存在本机 SQLite 中，涵盖预算、经常性支出、项目追踪和报表分析。

主要功能

01记录支出与收入
02创建和管理发票
03设置预算及经常性支出
04按类别和时间段分析数据
05管理多个项目
06导出交易与发票数据

适用场景

01随手记录业务开支和收入
02创建发票并标记付款状态
03检查预算使用情况和支出趋势
04导出交易记录供顾问查看

MCP 相关

该 MCP 服务向 Claude 等客户端提供支出、收入、发票、预算、分析和导出工具。数据保存在本地 SQLite 文件中。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "makz81-spendlog": {
      "command": "npx",
      "args": [
        "-y",
        "spendlog"
      ]
    }
  }
}

启动命令npx -y spendlog

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmspendlog1.0.4stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Spendlog

面向个体创业者的成本与费用跟踪工具，直接集成在 Claude Code 中。无需应用、电子表格或账号。

用自然语言跟踪业务支出、管理预算、开具发票。所有数据都 100% 保存在本地 SQLite 中，不会离开你的设备。

Claude 中的 Spendlog 月度摘要

兼容平台

Claude Code | Claude Desktop | VS Code | Cursor

快速开始

npx spendlog

或一键安装：

安装程序会自动配置 Claude Desktop 和 Claude Code。重启 Claude，然后试试：

“记录 50€ 的托管费用”

就这么简单。需要 Node.js 20+。

为什么选择 Spendlog？

无需切换上下文 — 随时记录成本，就在你日常工作的地方
本地优先 — 所有数据都存储在 ~/.spendlog/spendlog.db，无需账号或云服务
自然语言 — 无需填写表单或浏览菜单，只要告诉 Claude 你的支出即可
38 个工具 — 支持开具发票、管理预算、跟踪定期支出、导出 CSV 和跟踪多个项目
多语言 — 支持英语和德语（EN/DE），并已准备好通过 i18n 支持更多语言

示例

跟踪：

You: "29€ for ChatGPT subscription"
Claude: Expense saved: 29.00 € — Category: IT & Software

You: "Export 2025 for my accountant"
Claude: 247 transactions written to ~/spendlog-export-2025.csv

发票：

You: "Create invoice for TechCorp, web development, 8h at 95€/h"
Claude: Invoice #2026-004 created — 760.00 €

You: "Mark it as paid"
Claude: Invoice #2026-004 marked as paid, income recorded.

分析：

You: "How much did I spend on software this quarter?"
Claude: IT & Software: 287.00 € (12 transactions) — 23% of total expenses

You: "Compare January vs February"
Claude: Expenses up 15%. Biggest increase: Marketing (+120€)

工具

9 个类别，共 38 个工具：

类别	工具
交易	`add_expense` `add_income` `list_transactions` `update_transaction` `delete_transaction`
分析	`get_summary` `get_category_breakdown` `compare_periods` `get_tax_summary`
发票	`create_invoice` `list_invoices` `get_invoice` `mark_invoice_sent` `mark_invoice_paid` `delete_invoice` `duplicate_invoice`
预算	`set_budget` `get_budget_status` `list_budgets` `update_budget` `delete_budget`
定期支出	`create_recurring` `list_recurring` `delete_recurring` `process_recurring`
项目	`create_project` `list_projects` `rename_project` `delete_project`
类别	`list_categories` `add_category` `delete_category`
导出	`export_transactions` `export_invoices` `export_for_tax_advisor`
设置	`get_profile` `set_profile` `get_notifications`

配置

手动设置（如果安装程序未能正常工作）

Claude Desktop — 编辑配置文件：

{
  "mcpServers": {
    "spendlog": {
      "command": "npx",
      "args": ["-y", "--package=spendlog", "spendlog-mcp"]
    }
  }
}

Claude Code：

claude mcp add spendlog -- npx -y --package=spendlog spendlog-mcp

### 环境变量

变量	描述	默认值
`SPENDLOG_LANGUAGE`	`en` 或 `de`	`en`
`SPENDLOG_DATA_DIR`	数据目录路径	`~/.spendlog`
`DATABASE_PATH`	SQLite 数据库的完整路径	`$SPENDLOG_DATA_DIR/spendlog.db`
`SPENDLOG_PROJECT`	所有交易的默认项目	无

隐私

所有数据都保留在你的设备上，存储于本地 SQLite 文件中。无需账户，无云服务，无遥测——任何数据都不会发送到任何地方。

注意： Spendlog 是一款成本追踪工具，而非会计软件。请将其用于个人分析，而非正式记账或报税。

开发

使用 TypeScript（严格模式）、Vitest 进行测试，并使用 TypeORM + SQLite 存储。

git clone https://github.com/makz81/spendlog.git
cd spendlog
npm install
npm run dev       # MCP server with watch mode
npm run test      # 382 tests
npm run typecheck # type check (no emit)

有关架构详情以及如何添加新工具，请参阅 CONTRIBUTING.md。