内容
# 🧾 远程MCP服务器 - 费用跟踪器
一个使用 [FastMCP](https://gofastmcp.com) 构建的**远程MCP服务器**，允许您直接通过Claude AI跟踪费用 - 无需本地设置。只需连接并使用。
---
## ⚡ 如何使用此服务器（将其连接到Claude）
此服务器托管在互联网上。您只需要将URL添加到Claude配置中 - 无需安装，无需代码。
### 步骤 1 - 打开Claude桌面配置文件
**Windows:**
```
C:\Users\<YourName>\AppData\Roaming\Claude\claude_desktop_config.json
```
**Mac:**
```
~/Library/Application Support/Claude/claude_desktop_config.json
```
### 步骤 2 - 将此服务器添加到配置中
```json
{
"mcpServers": {
"expense-tracker": {
"url": "https://moksh-expense-tracker.fastmcp.app/mcp"
}
}
}
```
> 🔗 **服务器URL**: `https://moksh-expense-tracker.fastmcp.app/mcp`
### 步骤 3 - 重启Claude
关闭并重新打开Claude Desktop。现在，费用跟踪工具将可用！
### 步骤 4 - 开始使用
向Claude提问，例如：
- *"今天添加一项₹500的食物费用"*
- *"显示我所有的费用"*
- *"编辑费用ID 3，将金额更改为₹200"*
- *"删除费用ID 5"*
---
## 🛠️ 可用工具
| 工具 | 功能 |
|---|---|
| `add_expense` | 添加新的费用（金额，类别，日期，描述） |
| `list_expenses` | 查看所有已记录的费用 |
| `edit_expense` | 按ID更新现有费用 |
| `delete_expense` | 按ID删除费用 |
---
## 🚀 部署您自己的副本（可选）
想要托管您自己的实例？请按照以下步骤。
### 步骤 1 - Fork此仓库
点击此页面右上角的 **Fork**。
### 步骤 2 - 在FastMCP Cloud上创建帐户
前往：[https://horizon.prefect.io](https://horizon.prefect.io)
使用GitHub注册/登录。
### 步骤 3 - 连接您的fork仓库
- 点击 **"新建服务器"** → 选择 **GitHub**
- 选择您的fork仓库
### 步骤 4 - 配置部署
| 字段 | 值 |
|---|---|
| **分支** | `main` |
| **入口点** | `main.py` |
| **运行时** | `uv` |
| **Python版本** | `3.12` |
> 此项目不需要环境变量。
### 步骤 5 - 部署
点击 **部署** → 等待 ~1-2 分钟 → 获取您的公共URL：
```
https://your-server-name.fastmcp.app/mcp
```
在上面的使用指南的步骤 2 中使用此URL。
---
## 📁 项目结构
```
├── main.py # MCP服务器，包含所有工具 + 详细注释
├── pyproject.toml # 依赖项（fastmcp）
├── uv.lock # 锁定依赖项版本
├── .python-version # Python 3.12
└── .gitignore # 排除.venv，.db，.env文件
```
> ⚠️ **注意：** SQLite数据在每次重新部署时都会重置（短暂的云存储）。对于生产中的持久数据，请用PostgreSQL或Supabase替换SQLite。
