MCP Organizze

MCP Organizze

Servidor MCP para integración con el gestor financiero Organizze, compatible con cualquier cliente MCP (Claude Desktop, etc).

Este proyecto expone la API v2 de Organizze como herramientas de IA, permitiendo crear transacciones, consultar saldos, metas y mucho más.

✨ Funcionalidades

• Cuentas: Listar, crear y detallar cuentas bancarias.
• Transacciones: Crear (gastos/ingresos) y listar movimientos.
• Tarjetas de Crédito: Listar y detallar facturas.
• Categorías y Metas: Gestión completa.

🚀 Cómo Usar

Requisitos previos

Necesitarás tus credenciales de Organizze:

• ORGANIZZE_EMAIL: Tu correo de inicio de sesión.
• ORGANIZZE_API_KEY: Tu clave de API.

Opción 1: Vía UVX (Recomendada)

Si tienes uv instalado, puedes ejecutarlo directamente sin instalar nada:

# Executa em modo STDIO (padrão para Claude Desktop)
ORGANIZZE_EMAIL=seu@email.com ORGANIZZE_API_KEY=sua_chave uvx mcp-organizze

Para integrar con Claude Desktop, añade a tu archivo de configuración:

{
  "mcpServers": {
    "organizze": {
      "command": "uvx",
      "args": ["mcp-organizze"],
      "env": {
        "ORGANIZZE_EMAIL": "seu_email",
        "ORGANIZZE_API_KEY": "sua_chave_api"
      }
    }
  }
}

Opción 2: Vía Docker

La imagen Docker se ejecuta por defecto en modo Streamable HTTP (SSE) en el puerto 8000, ideal para uso remoto o en servidores.

Ejecutar con SSE (Puerto 8000):

docker run -p 8000:8000 \
  -e ORGANIZZE_EMAIL=seu_email \
  -e ORGANIZZE_API_KEY=sua_chave \
  mcp-organizze

Ejecutar con STDIO (Interactivo):

docker run -i \
  -e ORGANIZZE_EMAIL=seu_email \
  -e ORGANIZZE_API_KEY=sua_chave \
  mcp-organizze --transport stdio

Opción 3: Instalación Local (Pip/UV)

Clona el repositorio e instala:

uv pip install .
# ou
pip install .

Ejecuta el servidor:

python -m mcp_organizze

🛠 Desarrollo y Publicación

Estructura del Proyecto

• src/mcp_organizze: Código fuente del paquete.
• pyproject.toml: Configuración de build y dependencias.
• Dockerfile: Configuración para contenerización.
• .github/workflows: Actions para CI/CD.