Skip to main content
Glama
jjesusaf

Proflores MCP Server

by jjesusaf

Proflores MCP Server

Servidor MCP (Model Context Protocol) para el sistema de presupuestos de Proflores.

Stack

  • Python 3.12

  • MCP SDK (mcp[cli]>=1.26.0) con transporte Streamable HTTP

  • Supabase como base de datos

  • Deploy en Render (Docker)

Related MCP server: Streamline MCP

Estructura

mcp-server/
├── src/
│   ├── server.py                # Entry point
│   ├── tools/
│   │   ├── catalogs.py          # 8 tools de lectura de catálogos
│   │   ├── budget.py            # 6 tools de presupuestos
│   │   └── catalog_write.py     # 6 tools de escritura de catálogos
│   ├── resources/
│   │   └── schema.py            # 2 resources (schema del sistema)
│   ├── prompts/
│   │   └── budget.py            # 2 prompts para flujos guiados
│   └── services/
│       ├── supabase_client.py   # Singleton del cliente Supabase
│       └── helpers.py           # to_json, resolve_uuid
├── requirements.txt
├── Dockerfile
├── render.yaml
├── .env.example
└── .gitignore

Setup local

cp .env.example .env
# Editar .env con tus credenciales de Supabase

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

python src/server.py

El servidor estará disponible en http://localhost:8000/mcp/.

Tools disponibles (20)

Lectura de catálogos (8)

Tool

Descripción

list_companies

Lista empresas registradas

list_clients

Lista o busca clientes

list_projects

Lista proyectos con filtros

list_concepts

Lista conceptos (partidas de obra)

list_resources

Lista recursos (materiales, mano de obra, equipo)

list_units_of_measure

Lista unidades de medida

list_price_lists

Lista listas de precios

list_suppliers

Lista proveedores

Presupuestos (6)

Tool

Descripción

list_budgets

Lista presupuestos existentes

get_budget_detail

Detalle completo de un presupuesto

create_budget

Crea un presupuesto vacío (DRAFT)

add_budget_item

Agrega una partida a un presupuesto

update_budget

Actualiza campos de un presupuesto

update_budget_item

Actualiza una partida

Escritura de catálogos (6)

Tool

Descripción

create_client

Crea un nuevo cliente

create_concept

Crea un concepto (partida de obra)

create_apu

Crea un APU (Análisis de Precio Unitario)

add_apu_item

Agrega un recurso a un APU

create_resource

Crea un recurso (material, mano de obra, equipo)

set_resource_price

Asigna precio a un recurso en una lista de precios

Resources

  • schema://system-overview — Visión general del sistema

  • schema://budget-structure — Estructura de tablas de presupuestos

Prompts

  • budget_creation_assistant — Guía paso a paso para crear presupuestos

  • budget_review — Guía para revisar un presupuesto existente

Variables de entorno

Variable

Descripción

SUPABASE_URL

URL del proyecto Supabase

SUPABASE_SERVICE_ROLE_KEY

Service role key de Supabase

MCP_HOST

Host del servidor (default 0.0.0.0)

MCP_PORT

Puerto del servidor (default 8000)

Deploy

El proyecto está configurado para deploy en Render con Docker. Ver render.yaml.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to access and manage Streamline tasks, notes, tags, and workspaces via a Supabase-powered backend. It supports full CRUD operations, allowing users to search, create, update, and organize their productivity data through natural language.
    17
    6 npm
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides secure access to Supabase databases via PostgREST API and management tools for projects, schemas, branches, logs, and code generation.
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables interaction with Productive.io for task management, time tracking, budget monitoring, and project overview through natural language.
    83
    6 npm
    ISC