Test Remote MCP Server

💸 ExpenseTracker——MCP服务器+全栈Web应用程序

一个适用于生产的个人理财系统 两种方式同时:

这两种模式共享相同的SQLite数据库、类别分类、预算规则和经常性费用引擎，因此您通过web UI输入的任何内容都可以立即被AI工具看到，反之亦然。

______________________________________________________________________

目录

1. 实时链接
2. 功能概述
3. MCP服务器——完整参考

- 如何连接 - 所有工具 - 所有资源 - 示例提示

1. Web应用程序——完整参考

- 认证 - 仪表盘 - 费用管理 - 预算 - 经常性支出 - 配置文件和设置

1. 数据模型
2. 分类
3. 本地开发
4. 环境变量
5. 部署
6. 建筑
7. 技术栈

______________________________________________________________________

实时链接

______________________________________________________________________

功能概述

MCP侧（AI/Claude）

• ✅ 21种工具，涵盖整个费用生命周期
• ✅ 6个实时资源（类别、今天的支出、本月、预算、经常性、历史统计数据）
• ✅ 无状态HTTP传输——适用于任何兼容MCP的客户端
• ✅ 异步SQLite后端(aiosqlite)使用WAL模式

Web应用端

• ✅ Google OAuth登录
• ✅ 电话OTP登录（Twilio验证）
• ✅ 每用户数据隔离
• ✅ 月度仪表板，包括总计、类别细分、趋势
• ✅ 费用、预算和经常性项目的完整CRUD
• ✅ 带有系统偏好检测的暗/亮主题
• ✅ “复制MCP URL”按钮——直接从UI获取服务器端点
• ✅ 响应式设计（移动+桌面）

______________________________________________________________________

MCP服务器——完整参考

如何连接

MCP端点：

https://academic-gold-weasel.fastmcp.app/mcp

运输： 无状态HTTP(POST /mcp)

克劳德桌面(claude_desktop_config.json)

{
  "mcpServers": {
    "ExpenseTracker": {
      "url": "https://academic-gold-weasel.fastmcp.app/mcp"
    }
  }
}

ChatMCP/检查员

将端点URL直接粘贴到服务器字段中：

https://academic-gold-weasel.fastmcp.app/mcp

光标/风帆/VS代码（MCP扩展名）

{
  "mcp": {
    "servers": {
      "ExpenseTracker": {
        "url": "https://academic-gold-weasel.fastmcp.app/mcp",
        "transport": "http"
      }
    }
  }
}

______________________________________________________________________

所有工具

🧾 原油费用

add_expense --完整参数参考：

______________________________________________________________________

🔍 查询和列表

______________________________________________________________________

📊 报告和分析

______________________________________________________________________

💰 预算管理

______________________________________________________________________

🔁 经常性支出

frequency 值： monthly · weekly · yearly

______________________________________________________________________

所有资源

资源是以JSON形式公开的只读快照。任何MCP客户端都可以直接读取它们。

______________________________________________________________________

示例提示

将这些直接粘贴到Claude或任何与MCP连接的AI中：

Add an expense: ₹450 for lunch today, category food, subcategory dining_out, paid by UPI.

Show all my expenses from April 1 to April 5, 2026.

Give me a full monthly report for March 2026.

Compare my spending in February and March 2026.

Set a budget of ₹8000 for food in April 2026.

Show my budget status for this month.

What are my top 10 largest expenses this year?

Add a recurring expense: Netflix ₹649/month, category subscriptions/streaming, next due 2026-05-01.

Log this month's Netflix payment.

Show spending trends for the last 6 months.

Export my April 2026 expenses as CSV.

Search for all expenses with the note "office".

Show stats for Q1 2026 (Jan 1 to Mar 31).

______________________________________________________________________

Web应用程序——完整参考

实时网址： https://academic-gold-weasel.fastmcp.app

认证

web应用程序支持两种登录方法：

谷歌登录

• 使用您的Google帐户单击OAuth
• 无需密码
• 自动提取个人资料图片、姓名和电子邮件

电话OTP

• 输入您的电话号码和国家代码（例如。 +91XXXXXXXXXX)
• 通过短信接收一次性代码（由Twilio Verify提供支持）
• 输入登录代码

会话将持续 30天。浏览器重新启动后，您仍保持登录状态。

______________________________________________________________________

仪表盘

登录后，仪表板是主屏幕。它显示：

______________________________________________________________________

费用管理（网络）

可在 开支 选项卡：

• 增加支出 --日期、金额、类别（下拉菜单）、子类别、备注、标签、支付方式、货币
• 查看费用 --可按日期范围筛选的分页列表
• 编辑费用 --单击任何条目以更新任何字段
• 删除费用 --确认后删除
• 所有更改都会立即同步到共享数据库（在AI工具中也可见）

______________________________________________________________________

预算（网络）

可在 预算 选项卡：

• 设定预算 --选择一个月，选择一个类别，设置一个金额
• 预算跟踪器 --显示支出与限额的可视化进度条
• 超预算警报 --当类别超过其上限时，突出显示行
• 删除预算 --删除任何预算条目

______________________________________________________________________

经常性费用（网络）

可在 循环的 选项卡：

• 添加定期 --描述、金额、类别、频率（每月/每周/每年）、下一个到期日
• 查看活动重复 --按下一个截止日期排序
• 记录付款 --将一次事件标记为已支付，并自动提前下一个到期日
• 停用 --软删除而不丢失历史记录

______________________________________________________________________

配置文件和设置

可在 简介 选项卡：

______________________________________________________________________

数据模型

费用字段

其他桌子

______________________________________________________________________

分类

20个顶级类别，每个类别都定义了子类别 categories.json:

______________________________________________________________________

本地开发

先决条件

• Python 3.13+
• uv 包管理器

设置

# Clone the repo
git clone https://github.com/Sanjoy-Chattopadhay/Expense-Tracker-Expense-Manager.git
cd Expense-Tracker-Expense-Manager

# Install dependencies
uv sync

# Copy env template and fill in values
cp .env.example .env

跑

# Start the server (web app + MCP endpoint)
uv run python main.py

直接与Uvicorn一起跑步

uv run uvicorn app:app --host 0.0.0.0 --port 8000 --reload

将本地MCP连接到Claude Desktop

{
  "mcpServers": {
    "ExpenseTracker-local": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

______________________________________________________________________

环境变量

复制 .env.example 到 .env 并配置：

cp .env.example .env

注： 没有Twilio凭据，应用程序仍然可以工作——OTP代码被记录到服务器控制台，而不是通过短信发送，这对开发很有用。

______________________________________________________________________

部署

FastMCP地平线（当前）

此服务器部署在 FastMCP地平线.推到 main 以触发重新部署。

MCP端点： https://academic-gold-weasel.fastmcp.app/mcp

渲染（替代）

A. render.yaml 包含用于一键渲染部署的持久磁盘，安装在 /app/data:

1. 在Render仪表板中连接您的GitHub仓库
2. 渲染将检测 render.yaml 自动地
3. 在Render仪表板中设置secret env变量：

- GOOGLE_CLIENT_ID - MCP_URL - TWILIO_ACCOUNT_SID - TWILIO_AUTH_TOKEN - TWILIO_VERIFY_SERVICE_SID

1. 部署

码头工人

# Build
docker build -t expense-tracker .

# Run
docker run -p 8000:8000 \
  -e GOOGLE_CLIENT_ID=your_id \
  -e MCP_URL=http://localhost:8000/mcp \
  -v $(pwd)/data:/app/data \
  expense-tracker

数据库持久性说明

该应用程序使用SQLite。对于托管部署：

• 持久磁盘/卷装载 在 /app/data → 数据在重启和重新部署后仍能存活✅
• 临时文件系统 （例如Vercel、AWS Lambda）→ 重新部署时擦除数据❌

Render、Railway、Fly.io和自托管Docker都支持卷挂载。

______________________________________________________________________

建筑

┌─────────────────────────────────────────────────────────┐
│                        main.py                          │
│                                                         │
│  FastMCP("ExpenseTracker")                              │
│  ├── 21 MCP Tools  (async, aiosqlite)                   │
│  ├── 6  MCP Resources (sync, sqlite3)                   │
│  └── register_web_routes(mcp, DB_PATH, ...)             │
│       └── webapp.py                                     │
│            ├── /api/auth/*    (Google + OTP)            │
│            ├── /api/expenses  (CRUD)                    │
│            ├── /api/budgets   (CRUD)                    │
│            ├── /api/recurring (CRUD + log)              │
│            ├── /api/dashboard                           │
│            ├── /api/public-config  → MCP_URL            │
│            └── /  → serves web/index.html              │
│                                                         │
│  SQLite DB (data/expenses.db)                           │
│  ├── expenses        budgets         recurring          │
│  ├── app_users       app_sessions    app_otp_codes      │
│  ├── app_expenses    app_budgets     app_recurring       │
│                                                         │
└─────────────────────────────────────────────────────────┘
         ▲                              ▲
   MCP Clients                    Web Browser
   (Claude, ChatMCP,           (web/index.html +
    Cursor, Inspector)          app.js + styles.css)

关键设计决策：

• 单个FastMCP实例通过以下方式为MCP协议和自定义HTTP路由提供服务 @mcp.custom_route
• MCP工具使用 aiosqlite （异步）；MCP资源使用 sqlite3 （同步——FastMCP的资源模型要求）
• web应用程序有自己的用户/会话表(app_*)用于多用户隔离；MCP工具在共享平台上运行 expenses 桌子
• DB路径在启动时通过写探测回退链解析，因此服务器可以在任何平台上启动

______________________________________________________________________

技术栈

______________________________________________________________________

项目结构

.
├── main.py              # MCP server — all tools, resources, and app entry point
├── webapp.py            # Web app routes — auth, CRUD API, static file serving
├── app.py               # Minimal ASGI entry point for uvicorn
├── categories.json      # Expense category + subcategory taxonomy
├── web/
│   ├── index.html       # Single-page web application
│   ├── app.js           # Frontend logic (state, API calls, UI handlers)
│   └── styles.css       # Theme system, layout, responsive design
├── data/
│   └── expenses.db      # SQLite database (git-ignored)
├── Dockerfile           # Container image definition
├── render.yaml          # Render.com deployment config with persistent disk
├── pyproject.toml       # Python project metadata and dependencies
├── uv.lock              # Locked dependency tree
└── .env.example         # Template for all required environment variables

______________________________________________________________________

许可证

麻省理工学院——自由使用，感谢归因。