Snowflake Stored Procedure Integration

Integração de Stored Procedures do Snowflake com Servidor MCP

Este projeto simplifica a integração de stored procedures do Snowflake com um servidor MCP (Model Context Protocol). Ele fornece uma estrutura para definir, gerenciar e executar procedures do Snowflake a partir do ambiente do servidor MCP.

Requisitos

• Python 3.8 ou superior
• uv instalado

Instalação

1. Clone o repositório:

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

2. Instale as dependências usando uv:

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

Configuração

1. Crie um arquivo .env no diretório raiz (não faça commit deste arquivo). Defina todas as credenciais necessárias do 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 as variáveis são obrigatórias e devem ser definidas pelo usuário.

2. Configure o projeto como um servidor MCP. No seu arquivo de configuração do MCP, adicione uma entrada como a seguinte, ajustando os caminhos para corresponder ao seu ambiente local. Tanto --schemas quanto --procedures são opcionais e o padrão é listas vazias.

• Schemas: Todas as stored procedures nos schemas especificados estarão disponíveis para o servidor MCP.
• Procedures: Apenas as procedures especificadas estarão disponíveis para o 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"
      ]
    }
  }
}

Substitua absolute/path/to/snowflake-mcp-sp-integration pelo diretório real onde você clonou este repositório.

Guia de Início Rápido - Configuração para Ambiente de Desenvolvimento

A pasta quickstart/ contém um guia passo a passo para configurar e testar este módulo no Ambiente de Desenvolvimento.

Licença

Este projeto está licenciado sob a Licença MIT.