Fianance MCP

财务MCP服务器-Vercel部署

此文件夹包含为Vercel上的无服务器部署配置的财务MCP服务器。

📁 结构

vercel-deployment/
├── api/
│   ├── index.py          # Main Vercel handler
│   ├── app_tools.py      # MCP tools registration
│   └── database.py       # Database connection manager
├── vercel.json           # Vercel configuration
├── requirements.txt      # Python dependencies
├── .env.example          # Environment variables template
└── README.md            # This file

🚀 快速部署

1.安装Vercel CLI

npm install -g vercel

2.设置环境变量

创建 .env 文件（复制自 .env.example):

DATABASE_URL_PRIVATE="postgresql://user:pass@host/private?sslmode=require"
DATABASE_URL_PUBLIC="postgresql://user:pass@host/public?sslmode=require"

3.部署到Vercel

cd vercel-deployment
vercel

按照提示操作：

• 设置和部署？ Y
• 什么范围？选择您的帐户
• 链接到现有项目？ N （首次部署）
• 你的项目叫什么名字？ 金融mcp服务器
• 您的代码位于哪个目录中？ ./
• 想要覆盖设置吗？ N

4.向Vercel添加环境变量

部署后，添加您的机密：

# Add private database URL
vercel env add DATABASE_URL_PRIVATE

# Add public database URL
vercel env add DATABASE_URL_PUBLIC

或者通过Vercel仪表板添加它们：

1. 转到项目设置
2. 导航到“环境变量”
3. 添加 DATABASE_URL_PRIVATE 和 DATABASE_URL_PUBLIC
4. 重新部署： vercel --prod

🔧 配置

vercel.json

这 vercel.json 文件配置：

• Python运行时 用于无服务器功能
• 路由 处理MCP端点
• 环境变量 参考文献

生产部署

vercel --prod

您的MCP服务器将在以下网址提供：

https://your-project.vercel.app/mcp

📡 API终点

部署后，您的MCP服务器将可在以下位置访问：

• 主MCP端点: https://your-project.vercel.app/mcp
• 健康检查: https://your-project.vercel.app/

🔐 安全

1. 永不承诺 .env 文件 -它已经在里面了 .gitignore
2. 使用Vercel环境变量 生产秘密
3. 启用SSL -Vercel提供自动HTTPS
4. 数据库SSL -确保使用Neon数据库 ?sslmode=require

🧪 测试

本地测试

# Install dependencies
pip install -r requirements.txt

# Run locally
python api/index.py

服务器运行于 http://localhost:8080

测试MCP端点

curl https://your-project.vercel.app/mcp

📊 特性

所有19种金融工具都可用：

账户管理

• list_accounts -查看所有帐户
• get_account_balance -获取特定账户余额
• get_account_summary -完整的财务摘要

交易分析

• list_transactions -带过滤器的列表
• search_transactions -按商家搜索
• get_recurring_transactions -检测定期付款

分析

• get_spending_by_category -类别细分
• get_monthly_trends -收入/支出趋势
• get_top_merchants -顶级消费商家
• get_cashflow_summary -收入与支出

预算编制

• create_budget -创建新预算
• list_budgets -查看所有预算
• get_budget_status -预算与实际支出

公用事业

• get_available_categories -列出类别
• format_currency -格式化金额
• calculate_net_worth -计算净值

安全与政策

• get_tool_policy -获取工具访问策略
• list_tool_policies -列出所有政策
• validate_tool_access -验证权限

🔄 更新

要更新部署，请执行以下操作：

# Pull latest changes
git pull

# Navigate to vercel-deployment folder
cd vercel-deployment

# Redeploy
vercel --prod

📝 日志

实时查看日志：

vercel logs

或者在Vercel仪表板的项目“日志”部分查看。

🐛 故障排除

导入错误

确保所有Python文件都在 api/ 目录和依赖项位于 requirements.txt.

数据库连接问题

• 验证Vercel中的环境变量是否设置正确
• 检查数据库URL是否包括 ?sslmode=require
• 确保Neon数据库可访问

500服务器错误

检查Vercel日志： vercel logs 或在仪表板上

📚 资源

• Vercel文档
• Vercel Python运行时
• FastMCP文档
• Neon PostgreSQL

📞 支持

对于问题或疑问：

1. 检查Vercel日志
2. 审查环境变量
3. 测试数据库连接
4. 验证Python依赖关系

______________________________________________________________________

准备部署！ 🚀