个人理财MCP服务器
管理个人财务的MCP服务器：账户、交易、分析和预测。
先决条件
- 码头工人 y Docker Compose （建议选择）
- O： Python 3.11+, 紫外线 y PostgreSQL 14+
______________________________________________________________________
如何证明
选项1：所有与Docker（推荐）
# 1. Clonar el repositorio
git clone https://github.com/TU_USUARIO/personal-finance-mcp-server.git
cd personal-finance-mcp-server
# 2. Levantar PostgreSQL + app (migraciones automáticas)
docker compose -f infra/docker/docker-compose.yml up -d --build
# 3. Probar el servidor
docker compose -f infra/docker/docker-compose.yml run --rm -it app服务器启动并在STDIN上等待。使用 Ctrl+C 关闭它。
选项2：没有Docker（本地Python）
# 1. Clonar
git clone https://github.com/TU_USUARIO/personal-finance-mcp-server.git
cd personal-finance-mcp-server
# 2. Instalar dependencias (requiere uv: pip install uv)
uv sync --all-extras
# 3. Levantar solo PostgreSQL con Docker
docker compose -f infra/docker/docker-compose.yml up -d postgres
# 4. Configurar variables de entorno
cp .env.example .env
# 5. Migraciones
uv run alembic upgrade head
# 6. Iniciar servidor
uv run python -m app.mcp.server______________________________________________________________________
用MCP客户端测试
MCP检查员（浏览器）
# Con Docker
npx @modelcontextprotocol/inspector docker compose -f infra/docker/docker-compose.yml run --rm -it app
# Sin Docker (app local)
npx @modelcontextprotocol/inspector uv run python -m app.mcp.server光标o克劳德桌面
配置MCP服务器 绝对真理 铝 docker-compose.yml:
{
"mcpServers": {
"personal-finance": {
"command": "docker",
"args": [
"compose",
"-f", "C:\\ruta\\completa\\a\\tu\\proyecto\\infra\\docker\\docker-compose.yml",
"run", "--rm", "app"
]
}
}
}取代 C:\ruta\completa\a\tu\proyecto 按项目文件夹的实际路径。
版本 docs/RUN_AND_TEST.md 更多选择。
______________________________________________________________________
可用的工具
| 工具 | 描述 |
|---|---|
health_check | 检查与数据库的连接 |
get_token | 获取JWT进行测试 |
list_accounts | 列出名称、类型、货币和余额的账户 |
create_account | Crea cuenta（支票、储蓄、投资） |
edit_account | 编辑帐户（名称、类型、货币） |
delete_account | 删除帐户及其交易 |
adjust_account_balance | 手动调整帐户余额 |
transfer | 在账户之间转移资金（在来源地创造支出，在目的地创造收入） |
get_categories | 列出建议的预定义类别（收入/支出） |
list_transactions | 列出过滤器事务（帐户、日期、类别、类型） |
export_transactions | 导出器转换CSV或JSON |
get_transaction | 按ID获取事务 |
add_transaction | 增加交易（收入/支出） |
edit_transaction | 编辑现有交易 |
delete_transaction | 删除交易并恢复资产负债表 |
get_financial_status | 资产负债表总额，按账户，按货币，月流量，储蓄率 |
analyze_month | 具体月份分析 |
forecast_balance | N个月资产负债表预测 |
detect_anomalies | 检测异常交易（Z-Score） |
generate_expense_report | 生成支出PDF（按类别、饼图） |
generate_income_expense_report | 生成收入/支出PDF（储蓄率，条形图） |
______________________________________________________________________
快速测试
- 健康检查 →验证一切正常
- 创建计数 →
name="Mi cuenta",account_type="checking" - add_transaction →使用
account_id返回：amount=50,transaction_type="expense",category="comida",transaction_date="2025-02-20" - 获取_财务状态 →查看聚合状态
______________________________________________________________________
开发命令
uv run pytest # Ejecutar tests
uv run alembic upgrade head # Aplicar migraciones
uv run alembic revision --autogenerate -m "desc" # Nueva migración