mcpField
S
Spendlog

Spendlog

ローカル
github.com/makz81金融データ121 週間前に更新

Spendlog について

Spendlogは、個人事業主向けに経費や請求書を自然言語で管理するローカル型のMCPサーバーです。Claudeなどの対応環境で利用でき、データはSQLiteに保存されます。予算、定期支出、プロジェクト管理、分析にも対応します。

主な機能

  1. 01支出と収入の記録
  2. 02請求書の作成と管理
  3. 03予算と定期支出の設定
  4. 04カテゴリや期間別の分析
  5. 05複数プロジェクトの管理
  6. 06取引と請求書データのエクスポート

活用シーン

  1. 01事業の支出や収入を随時記録する
  2. 02請求書を作成して支払状況を更新する
  3. 03予算の使用状況や支出傾向を確認する
  4. 04顧問向けに取引記録を出力する

MCP 対応

Claudeなどのクライアントに、支出、収入、請求書、予算、分析、エクスポートのツールを提供します。データはローカルのSQLiteファイルに保存されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"makz81-spendlog": {
"command": "npx",
"args": [
"-y",
"spendlog"
]
}
}
}
起動コマンドnpx -y spendlog

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmspendlog1.0.4

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Spendlog

Claude Code 内で使える、個人事業主向けのコスト・経費管理ツールです。アプリも、スプレッドシートも、アカウントも不要です。

事業の支出を記録し、予算を管理し、請求書を作成できます。すべて自然言語で操作できます。データはすべてローカルの SQLite に保存され、マシンの外に送信されることはありません。

npm バージョン npm ダウンロード数 CI MCP ツール 38 個 テスト 382 件合格 MIT ライセンス

Claude での Spendlog 月次サマリー

対応環境

Claude Code | Claude Desktop | VS Code | Cursor

クイックスタート
npx spendlog

または、ワンクリックでインストールできます。

VS Code にインストール Cursor にインストール

インストーラーが 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_LANGUAGEen または deen
SPENDLOG_DATA_DIRデータディレクトリのパス~/.spendlog
DATABASE_PATHSQLite データベースのフルパス$SPENDLOG_DATA_DIR/spendlog.db
SPENDLOG_PROJECTすべての取引に適用するデフォルトのプロジェクトなし

プライバシー

すべてのデータは、お使いのマシン上のローカル SQLite ファイルに保存されます。アカウントもクラウドもテレメトリーもなく、データが外部に送信されることは一切ありません。

注: Spendlog は支出トラッカーであり、会計ソフトウェアではありません。公式な帳簿付けや税務申告ではなく、ご自身の分析にご利用ください。

開発

TypeScript(strict)、テストには 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 をご覧ください。

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。