MCP Gastos

MCP成本

通过CSV文件管理个人支出的MCP服务器（模型上下文协议）。该项目由FastMCP构建，允许人工智能代理以结构化的方式添加、查询和分析支出。

🚀 特点

• 工具: agregar_gasto -向CSV注册添加新支出
• 资源: resource://gastos -查询LLMS消费的格式化成本
• 提示：生成过去5天支出摘要的模板
• 验证：确保一致性的支付方法列表
• 统计数据：按类别和付款方式自动计算总额

📋 要求

• Python>=3.14
• 快速MCP>=2.13.1

🔧 安装

1. 克隆存储库：

git clone https://github.com/BrayanTM/mcp-basico.git
cd mcp-basico

1. 安装依赖项：

pip install fastmcp

🎯 使用

运行MCP服务器

python main.py

CSV结构

档案馆 gastos.csv 使用以下结构：

Fecha,Categoría,Cantidad,Método de pago
2025-11-16,Alimentación,45.50,Tarjeta de crédito

专栏：

• 日期：ISO 8601格式（YY-MM-DD）
• 分类：自由文本（例如：“食物”、“交通”、“健康”）
• 数量：小数点后2位
• 付款方式：已验证的枚举（借记卡、信用卡、现金）

MCP的功能

工具： agregar_gasto

向CSV文件添加新支出：

agregar_gasto(
    fecha="2025-11-16",
    categoria="Alimentación",
    cantidad=45.50,
    metodo_pago=MetodoPago.TARJETA_CREDITO
)

参数：

• fecha （STR）：YYY-MM-DD格式的日期
• categoria （STR）：支出类别
• cantidad （浮动）：支出金额
• metodo_pago （方法付款）：有有效值的枚举

资源： resource://gastos

以结构化标记格式返回所有支出，包括：

• 记录的总费用
• 支出总额
• 按类别分组的小计
• 所有费用的详细清单

提示： prompt_agregar_gasto

生成过去5天支出的智能摘要，按天和类别分组。

📂 项目结构

mcp-basico/
├── main.py           # Servidor MCP con tools, resources y prompts
├── gastos.csv        # Archivo de datos (generado automáticamente)
├── pyproject.toml    # Configuración del proyecto
└── README.md         # Documentación

🔐 有效付款方式

服务器通过枚举验证付款方法：

• MetodoPago.TARJETA_DEBITO →“借记卡”
• MetodoPago.TARJETA_CREDITO →“信用卡”
• MetodoPago.EFECTIVO →“有效”

📊 输出示例

查询资源时 resource://gastos，您将获得以下格式：

# Registro de Gastos

Total de gastos registrados: 34

Total gastado: $1,724.54

## Gastos por Categoría

### Alimentación
- Cantidad de gastos: 11
- Total: $525.20

### Transporte
- Cantidad de gastos: 6
- Total: $93.50

...

🛠️ 发展公约

• 编码：始终使用 utf-8 与特殊字符兼容
• CSV使用： newline='' 以写模式打开文件时
• 数量格式：总是 .2f 对于两个小数
• 错误处理：尝试/除非有西班牙语描述信息
• 输出参数LLM：具有明确层次结构的标记

👤 作者

BrayanTM

• github： @BrayanTM

______________________________________________________________________

备注：该MCP服务器旨在由实现MCP协议的AI代理使用，从而允许使用自然语言进行自动费用管理。