Automatizar Backend con Agentes IA: Guía Paso a Paso

Paso 1: Configuración del Entorno

# Crear entorno virtual

python -m venv mcp-env

source mcp-env/bin/activate  # Linux/Mac

# mcp-env\Scripts\activate  # Windows

# Instalar dependencias

pip install fastapi-mcp uvicorn

Paso 2: Estructura del Proyecto

proyecto/

├── frontend/

│   ├── components/

│   ├── pages/

│   └── styles/

├── backend/

│   ├── main.py

│   ├── models/

│   ├── routes/

│   └── config/

└── mcp_config.json

Paso 3: Implementación del Backend

# backend/main.py

from fastapi import FastAPI, HTTPException

from fastapi_mcp import MCPServer

from pydantic import BaseModel

from typing import List, Optional

import uvicorn

app = FastAPI(title=»Dashboard Financiero IA»)

# Modelo de datos

class Transaction(BaseModel):

    id: Optional[int] = None

    description: str

    amount: float

    type: str  # «income» o «expense»

    date: str

# Base de datos simulada

transactions_db = []

transaction_counter = 1

# Endpoints principales

@app.post(«/transactions/»)

async def create_transaction(transaction: Transaction):

    global transaction_counter

    transaction.id = transaction_counter

    transaction_counter += 1

    transactions_db.append(transaction)

    return {«message»: «Transacción creada», «transaction»: transaction}

@app.get(«/transactions/»)

async def list_transactions():

    return {«transactions»: transactions_db}

@app.delete(«/transactions/{transaction_id}»)

async def delete_transaction(transaction_id: int):

    for i, trans in enumerate(transactions_db):

        if trans.id == transaction_id:

            deleted = transactions_db.pop(i)

            return {«message»: «Transacción eliminada», «transaction»: deleted}

    raise HTTPException(status_code=404, detail=»Transacción no encontrada»)

@app.get(«/stats/»)

async def get_stats():

    total_income = sum(t.amount for t in transactions_db if t.type == «income»)

    total_expenses = sum(t.amount for t in transactions_db if t.type == «expense»)

    balance = total_income – total_expenses

    return {

        «total_income»: total_income,

        «total_expenses»: total_expenses,

        «balance»: balance,

        «transaction_count»: len(transactions_db)

    }

# Configuración MCP

mcp_server = MCPServer(app)

mcp_server.expose_endpoints([

    «create_transaction»,

    «list_transactions», 

    «delete_transaction»,

    «get_stats»

])

if __name__ == «__main__»:

    uvicorn.run(app, host=»0.0.0.0″, port=8000)

Paso 4: Configuración MCP para windsurf

{

  «mcpServers»: {

    «fastapi-dashboard»: {

      «command»: «python»,

      «args»: [«-m», «fastapi_mcp.server»],

      «env»: {

        «FASTAPI_URL»: «http://localhost:8000»

      }

    }

  }

}