AI导哈

个人财务服务器

用于管理个人财务的服务器，包括账户、交易、分析和预测功能。

  • by CRPA22
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 CRPA22/personal-finance-mcp-server

使用说明

个人理财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（储蓄率，条形图）

快速测试

  1. 健康检查 →验证一切正常
  2. 创建计数 → name="Mi cuenta", account_type="checking"
  3. add_transaction →使用 account_id 返回： amount=50, transaction_type="expense", category="comida", transaction_date="2025-02-20"
  4. 获取_财务状态 →查看聚合状态

开发命令

uv run pytest                    # Ejecutar tests
uv run alembic upgrade head      # Aplicar migraciones
uv run alembic revision --autogenerate -m "desc"  # Nueva migración

相关 MCP