Snowflake Stored Procedure Integration

Integración de Procedimientos Almacenados de Snowflake con Servidor MCP

Este proyecto simplifica la integración de procedimientos almacenados de Snowflake con un servidor MCP (Protocolo de Contexto de Modelo). Proporciona un marco para definir, gestionar y ejecutar procedimientos de Snowflake desde el entorno del servidor MCP.

Requisitos

• Python 3.8 o superior
• uv instalado

Instalación

1. Clona el repositorio:

git clone https://github.com/Cjaimesg/snowflake-mcp-sp-integration.git
cd snowflake-mcp-sp-integration

2. Instala las dependencias usando uv:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Configuración

1. Crea un archivo .env en el directorio raíz (no lo incluyas en el control de versiones). Define todas las credenciales requeridas de Snowflake:

SNOWFLAKE_ACCOUNT=<xxx>-<xxx>
SNOWFLAKE_USER=<xxx>
SNOWFLAKE_PASSWORD=<xxx>
SNOWFLAKE_ROLE=<xxx>
SNOWFLAKE_WAREHOUSE=<xxx>
SNOWFLAKE_DATABASE=<xxx>
SNOWFLAKE_SCHEMA=<xxx>
SNOWFLAKE_HOST=<xxx>-<xxx>.snowflakecomputing.com

Todas las variables son obligatorias y deben ser definidas por el usuario.

2. Configura el proyecto como un servidor MCP. En tu archivo de configuración de MCP, agrega una entrada como la siguiente, ajustando las rutas para que coincidan con tu entorno local. Tanto --schemas como --procedures son opcionales y tienen como valor predeterminado listas vacías.

• Schemas: Todos los procedimientos almacenados en los esquemas especificados estarán disponibles para el servidor MCP.
• Procedures: Solo los procedimientos especificados estarán disponibles para el servidor MCP.

{
  "mcpServers": {
    "snowflake_sp_server": {
      "command": "absolute/path/to/your/uv/uv.exe",
      "args": [
        "--directory",
        "absolute/path/to/snowflake-mcp-sp-integration",
        "run",
        "main.py",
        "--schemas",
        "DB_NAME.SCHEMA_NAME",
        "--procedures",
        "DB_NAME.OTHER_SCHEMA_NAME.PROCEDURE_NAME"
      ]
    }
  }
}

Reemplaza absolute/path/to/snowflake-mcp-sp-integration con el directorio real donde clonaste este repositorio.

Inicio rápido - Guía de configuración para entorno de desarrollo

La carpeta quickstart/ contiene una guía paso a paso para configurar y probar este módulo en el Entorno de Desarrollo.

Licencia

Este proyecto está licenciado bajo la Licencia MIT.