Finance Intelligence MCP

Name: Finance Intelligence MCP
Author: Ronit-019

作者：Ronit-019バージョン 1.0.0i★ –iパソコンで動く

レジストリ名io.github.Ronit-019/finance-intelligence-mcp

インストール

概要

作者による説明（英語の原文）

Personal finance MCP server with budgeting, analytics, and PostgreSQL.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: 会計・財務・税務
入力が必要なもの：DATABASE_URL

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： DATABASE_URL

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

PyPIPythonのuvのインストール（uvxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "finance-intelligence": {
      "command": "uvx",
      "args": [
        "finance-intelligence-mcp"
      ],
      "env": {
        "DATABASE_URL": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add finance-intelligence --env DATABASE_URL=your-value -- uvx finance-intelligence-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "finance-intelligence": {
      "command": "uvx",
      "args": [
        "finance-intelligence-mcp"
      ],
      "env": {
        "DATABASE_URL": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "finance-intelligence": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "finance-intelligence-mcp"
      ],
      "env": {
        "DATABASE_URL": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

DATABASE_URL 秘密必須 env
PostgreSQL connection string.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント Ronit-019 で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

会計・財務・税務のほかのサーバーとの比較i

このカテゴリのほかの2908件のうち0%よりスターが多い
このカテゴリのほかの2908件のうち17%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの2908件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Finance Intelligence MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：DATABASE_URL

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（1.0.0）がレジストリに届いたのは4 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは？

同じカテゴリには：Finance Toolkit, SolidInvoice, Korea Tax Calculator

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Finance Toolkit

作者：JerBouma

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

パソコンでもクラウドでも★ 5,496MIT昨日更新

インストール

SolidInvoice

作者：SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

クラウドで動く★ 981MIT8 日前更新

インストール

Korea Tax Calculator

作者：UpstageAI

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

パソコンで動く★ 97MIT昨日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Finance Intelligence MCP Server

Finance Intelligence MCP is a production-ready Model Context Protocol (MCP) server that enables AI assistants (like Claude, Cursor, and others) to securely manage and analyze personal finances through natural language.

Released under the MIT License and designed to be extended with additional finance tools.

🔍 Overview

Unlike standard cloud-based personal finance apps, Finance Intelligence MCP keeps all financial data under your absolute control.

No Accounts / Subscriptions: Direct connection to your private database with zero SaaS dependencies.
Zero Telemetry: Your financial logs never go to external analytic APIs.
Full AI Context: Your AI assistant can query history, check budget status, make charts, and answer financial questions instantly.

🛠️ Architecture

   ┌────────────────────────────────┐

│ MCP Client │ │ (Claude Desktop, Cursor, etc) │ └───────────────┬────────────────┘ │ │ (STDIO Transport Protocol) ▼ ┌────────────────────────────────┐ │ Finance Intelligence Server │ │ (Local) │ └───────────────┬────────────────┘ │ │ (Direct SQL Pool Connection) ▼ ┌────────────────────────────────┐ │ PostgreSQL Database │ │ (Supabase, Local, RDS, etc) │ └────────────────────────────────┘

✨ Features

Expense Operations: Create, view, edit, and bulk-delete expense entries.
Multi-level Budgeting: Set limits for overall spending, specific category thresholds, or down to nested subcategory targets.
Analytics Breakdowns: Aggregate expenses by category, subcategory, notes, or dates over weekly/monthly/yearly time blocks.
Visual Charts: Exposes tools that generate Matplotlib line/bar charts of historical spending automatically.
Excel Spreadsheet Export: Truncates long list responses and generates download-ready Excel spreadsheets for massive datasets.
Financial Health Scoring: Calculates a deterministic financial health score grade based on 6 core personal finance KPIs.

⚙️ Requirements & Compatibility

Transport: stdio
Supported Platforms:
Windows
macOS
Linux
Python Compatibility: Python 3.10, 3.11, and 3.12 (Tested)
Database: PostgreSQL 12+ (e.g. Supabase, RDS, or local Postgres)
Supported Clients:
Claude Desktop
Cursor
*Compatible with any MCP client supporting stdio.*

💾 Installation & Setup

1. Quick Setup (Shortcut)

If you have uv installed, get started in 2 lines:

git clone https://github.com/Ronit-019/Finance-Intelligence-MCP.git

cd Finance-Intelligence-MCP uv sync

2. Detailed Installation

Step A: Get a PostgreSQL Connection URL

The easiest, free option is Supabase:

Go to Supabase and create a free project.
Go to Project Settings (gear icon) > Database.
Under Connection string, select URI and copy the string.

*Example*: postgresql://postgres.[your-project-ref]:[your-password]@aws-0-us-east-1.pooler.supabase.com:5432/postgres
*(Replace [your-password] with your database password).*

Step B: Clone the Repository

Clone the codebase to a directory on your machine:

git clone https://github.com/Ronit-019/Finance-Intelligence-MCP.git

cd Finance-Intelligence-MCP

Copy the absolute path of this directory (e.g. `C:/Users/Admin/Desktop/Finance-Intelligence-MCP`).

*Note: Always use forward slashes (/) for paths in JSON configs.*

Step C: Install Dependencies

If you do not have uv installed, install from the project metadata:

pip install -e .

3. Client Integration

Claude Desktop Setup

Open your Claude configuration file (claude_desktop_config.json):

Windows: Press Win + R, paste %APPDATA%\Claude\claude_desktop_config.json and press Enter.
macOS: Paste ~/Library/Application Support/Claude/claude_desktop_config.json in Finder's Go to Folder.

Add this entry to mcpServers:

"mcpServers": { "finance-intelligence": { "command": "uv", "args": [ "--directory", "REPLACE_WITH_ABSOLUTE_PATH_TO_CLONED_DIRECTORY", "run", "python", "main.py" ], "env": { "DATABASE_URL": "REPLACE_WITH_YOUR_SUPABASE_CONNECTION_STRING" } } } }

3. Save and completely **restart Claude Desktop**.

Cursor IDE Setup

Go to Settings > Features > MCP.
Click + Add New MCP Server:

Name: Finance Intelligence
Type: command
Command: bash uv --directory "REPLACE_WITH_ABSOLUTE_PATH_TO_CLONED_DIRECTORY" run python main.py

Click + Add Env Var:

Key: DATABASE_URL
Value: REPLACE_WITH_YOUR_SUPABASE_CONNECTION_STRING

Click Save and refresh.

💬 Example Prompts

Once configured, try talking to your AI assistant:

*"Add ₹250 for lunch today under food."*
*"Show my spending breakdown this month."*
*"Generate an Excel report of all my expenses between May and July."*
*"Am I exceeding my monthly budget limit?"*
*"How much did I spend on dining out this week?"*
*"Calculate my monthly financial health score and give me feedback."*
*"Generate a spending chart for the last 30 days."*

🛠️ Available Tools

The server registers 12 core tools on the client:

Tool Name	Parameters	Description
`add_expense`	`date`, `amount`, `category`, `subcategory`, `note`	Inserts a new expense transaction.
`list_expenses`	`start_date`, `end_date`	Lists transactions, exports to Excel if count > 50.
`expense_breakdown`	`start_date`, `end_date`, `group_by`, `breakdown`, `category`, `subcategory`	Aggregates spending sums and counts.
`delete_expenses`	`expense_ids`, `start_date`, `end_date`, `category`, `subcategory`	Deletes expenses matching filters.
`update_expenses`	`expense_ids`, `filter_...`, `date`, `amount`, `category`, `subcategory`, `note`	Edits expense records.
`create_budget`	`budget_type`, `amount`, `period`, `start_date`, `end_date`, `category`, `subcategory`, `budgets`	Registers new spending limits.
`list_budgets`	`budget_type`, `category`, `subcategory`, `period`	Returns registered budgets.
`update_budgets`	`budget_ids`, `filter_...`, `budget_type`, `amount`, `period`, `start_date`, `end_date`, `category`, `subcategory`	Modifies active budgets.
`delete_budgets`	`budget_ids`, `start_date`, `end_date`, `budget_type`, `category`, `subcategory`, `period`	Deletes target budget limits.
`compare_budget_vs_expenses`	`reference_date`, `budget_type`, `category`, `subcategory`, `period`	Compares budget vs actual spending.
`expense_summary`	`period`, `group_by`, `category`, `subcategory`, `start_date`, `end_date`	Generates a Matplotlib line/bar chart.
`financial_health_score`	`reference_month`	Evaluates 6 key personal finance indicators.

💡 Troubleshooting

1. `uv: command not found`

If the client cannot locate uv, update your config file to run standard Python:

Ensure you ran pip install -e . inside the repository.
Update config:

"finance-intelligence": {

"command": "python", "args": [ "REPLACE_WITH_ABSOLUTE_PATH_TO_CLONED_DIRECTORY/main.py" ], "env": { "DATABASE_URL": "REPLACE_WITH_YOUR_SUPABASE_CONNECTION_STRING" } }

2. Invalid `DATABASE_URL` / PostgreSQL Connection Errors

Make sure you replaced [your-password] with your actual database password in the Supabase URI string.
Ensure there are no surrounding spaces or special characters in the URL string.
Verify your Supabase instance is active and not paused.

3. Claude Not Detecting the Server

Double check that the folder paths in claude_desktop_config.json use forward slashes (/), even on Windows.
Check the logs at %APPDATA%\Claude\logs\mcp*.log (Windows) or ~/Library/Logs/Claude/mcp*.log (macOS) to see the exact startup error.

📁 Repository Structure

├── src/                       # Helper packages

│ ├── init.py │ ├── budget.py # Budget database operations │ ├── analytics.py # Breakdown aggregations & Matplotlib routines │ └── health.py # KPIs and financial health calculator ├── main.py # FastMCP Server application ├── categories.json # Category mapping catalog ├── pyproject.toml # Dependencies ├── LICENSE # MIT License file └── README.md # This file

🤝 Contributing

Contributions, bug reports, and feature requests are welcome! Please open an issue before submitting major changes or pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨💻 Author

Ronit Rajput

Portfolio: https://ronitportfolio-seven.vercel.app/assistant
GitHub: https://github.com/Ronit-019
LinkedIn: https://www.linkedin.com/in/ronit-rajput/

Finance Intelligence MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

会計・財務・税務のほかのサーバーとの比較i

よくある質問

代わりの候補

Finance Toolkit

SolidInvoice

Korea Tax Calculator

作者のREADME

Finance Intelligence MCP Server

🔍 Overview

🛠️ Architecture

✨ Features

⚙️ Requirements & Compatibility

💾 Installation & Setup

1. Quick Setup (Shortcut)

2. Detailed Installation

Step A: Get a PostgreSQL Connection URL

Step B: Clone the Repository

Step C: Install Dependencies

3. Client Integration

Claude Desktop Setup

Cursor IDE Setup

💬 Example Prompts

🛠️ Available Tools

💡 Troubleshooting

1. uv: command not found

2. Invalid DATABASE_URL / PostgreSQL Connection Errors

3. Claude Not Detecting the Server

📁 Repository Structure

🤝 Contributing

📄 License

👨💻 Author

1. `uv: command not found`

2. Invalid `DATABASE_URL` / PostgreSQL Connection Errors