使用说明
ExpenseTracker快速MCP项目
这是一个 开支追踪器 使用 FastMCP 和 aiosqlite。它支持 代理连接 对于像Claude这样的远程客户端,以及本地和云部署。
特性
- 添加、列出和汇总费用
- 异步SQLite数据库
- 具有可选自定义类别的默认类别
- 用于连接远程客户端的代理支持
- 与FastMCP工具和资源完全兼容
安装
- 克隆存储库:
git clone https://github.com/yourusername/ExpenseTracker.git
cd ExpenseTracker
- 安装依赖项:
pip install fastmcp aiosqlite
- 可选: 确保已安装Python>=3.13。
2.️⃣ 在本地运行服务器
开发模式(热重载)
uv运行fastmcp-dev-Main.py
正常运行
uv运行fastmcp运行Main.py
服务器将于启动http://0.0.0.0:8000默认情况下。
3.️⃣ 通过代理连接Claude Desktop或其他客户端
启动代理以连接远程客户端,如Claude
uv运行fastmcp安装claude桌面proxyfile.py
或者使用Python:
从fastmcp导入fastmcp
连接到您的FastMCP云服务器
mcp=FastMCP.as_proxy( "https://Maryams.fastmcp.app/mcp", name=“Maryam服务器代理” )
### Example CLI for connecting a local proxy to Claude Desktop
```bash
# Run proxy server to connect Claude
uv run fastmcp install claude-desktop proxy-server.py
- 这允许Claude(或其他客户端)在不需要FastMCP Pro的情况下进行连接。
- 使用
/mcp如果您的服务器是远程部署的,则来自FastMCP Cloud的URL。
FastMCP工具命令
增加支出
await add_expense(date="2025-11-28", amount=100.5, category="Food & Dining")
列出费用
await list_expenses(start_date="2025-11-01", end_date="2025-11-28")
汇总费用
await summarize(start_date="2025-11-01", end_date="2025-11-28", category="Food & Dining")
类别资源
categories() # Returns JSON of default or custom categories
在FastMCP云上部署
- 登录 FastMCP云.
- 创建新项目并上传
MCPServer.py. - 选择 公共 开放获取或 私有的 使用API令牌。
- 使用
/mcp远程连接的URL。
备注
- 数据库存储在临时文件夹中,以便进行写访问。
- 在以下情况下使用默认类别
categories.json不存在。 - 与Claude和其他FastMCP客户端完全兼容。
