Snowflake MCP-Server

Schmiedeabzeichen PyPI - Version

Überblick

Eine Model Context Protocol (MCP)-Serverimplementierung, die die Datenbankinteraktion mit Snowflake ermöglicht. Dieser Server ermöglicht die Ausführung von SQL-Abfragen über Tools und stellt Dateneinblicke und Schemakontext als Ressourcen bereit.

Related MCP server: Datadog MCP Server

Komponenten

Ressourcen

memo://insights
Ein ständig aktualisiertes Memo, das die gewonnenen Datenerkenntnisse zusammenfasst.
Wird automatisch aktualisiert, wenn neue Erkenntnisse über das Tool append_insight angehängt werden.
context://table/{table_name}
(Wenn Prefetch aktiviert ist) Schemazusammenfassungen pro Tabelle, einschließlich Spalten und Kommentaren, werden als einzelne Ressourcen angezeigt.

Werkzeuge

Der Server stellt die folgenden Tools bereit:

Abfragetools

read_query
Führen Sie SELECT -Abfragen aus, um Daten aus der Datenbank zu lesen.
Eingang:
- query (Zeichenfolge): Die auszuführende SELECT SQL-Abfrage
  Gibt zurück: Abfrageergebnisse als Array von Objekten
write_query (nur aktiviert mit --allow-write )
Führen Sie INSERT , UPDATE oder DELETE -Abfragen aus.
Eingang:
- query (Zeichenfolge): Die SQL-Änderungsabfrage
  Rückgabe: Anzahl der betroffenen Zeilen oder Bestätigung
create_table (nur aktiviert mit --allow-write )
Erstellen Sie neue Tabellen in der Datenbank.
Eingang:
- query (Zeichenfolge): CREATE TABLE SQL-Anweisung
  Rückgabe: Bestätigung der Tabellenerstellung

Schema-Tools

list_databases
Listen Sie alle Datenbanken in der Snowflake-Instanz auf.
Gibt zurück: Array von Datenbanknamen
list_schemas
Listet alle Schemata innerhalb einer bestimmten Datenbank auf.
Eingang:
- database (Zeichenfolge): Name der Datenbank
  Gibt zurück: Array von Schemanamen
list_tables
Listet alle Tabellen innerhalb einer bestimmten Datenbank und eines bestimmten Schemas auf.
Eingang:
- database (Zeichenfolge): Name der Datenbank
- schema (Zeichenfolge): Name des Schemas
  Gibt zurück: Array von Tabellenmetadaten
describe_table
Zeigen Sie Spalteninformationen für eine bestimmte Tabelle an.
Eingang:
- table_name (Zeichenfolge): Vollqualifizierter Tabellenname ( database.schema.table )
  Rückgabe: Array von Spaltendefinitionen mit Namen, Typen, Nullbarkeit, Standardwerten und Kommentaren

Analysetools

append_insight
Fügen Sie der Memoressource neue Dateneinblicke hinzu.
Eingang:
- insight (Zeichenfolge): Durch Analyse gewonnene Dateneinblicke
  Rücksendungen: Bestätigung der Erkenntnisaufnahme
  Effekt: Löst eine Aktualisierung der Ressource memo://insights aus

Verwendung mit Claude Desktop

Installation über Smithery

So installieren Sie Snowflake Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install mcp_snowflake_server --client claude

Installation über UVX

"mcpServers": {
  "snowflake_pip": {
    "command": "uvx",
    "args": [
      "--python=3.12",  // Optional: specify Python version <=3.12
      "mcp_snowflake_server",
      "--account", "your_account",
      "--warehouse", "your_warehouse",
      "--user", "your_user",
      "--password", "your_password",
      "--role", "your_role",
      "--database", "your_database",
      "--schema", "your_schema"
      // Optionally: "--allow_write"
      // Optionally: "--log_dir", "/absolute/path/to/logs"
      // Optionally: "--log_level", "DEBUG"/"INFO"/"WARNING"/"ERROR"/"CRITICAL"
      // Optionally: "--exclude_tools", "{tool_name}", ["{other_tool_name}"]
    ]
  }
}

Lokale Installation

Installieren Sie die Claude AI Desktop App
Installieren Sie uv :

curl -LsSf https://astral.sh/uv/install.sh | sh

Erstellen Sie eine .env Datei mit Ihren Snowflake-Anmeldeinformationen:

SNOWFLAKE_USER="xxx@your_email.com"
SNOWFLAKE_ACCOUNT="xxx"
SNOWFLAKE_ROLE="xxx"
SNOWFLAKE_DATABASE="xxx"
SNOWFLAKE_SCHEMA="xxx"
SNOWFLAKE_WAREHOUSE="xxx"
SNOWFLAKE_PASSWORD="xxx"
# Alternatively, use external browser authentication:
# SNOWFLAKE_AUTHENTICATOR="externalbrowser"

[Optional] Ändern Sie runtime_config.json , um Ausschlussmuster für Datenbanken, Schemas oder Tabellen festzulegen.
Lokal testen:

uv --directory /absolute/path/to/mcp_snowflake_server run mcp_snowflake_server

Fügen Sie den Server zu Ihrer claude_desktop_config.json hinzu:

"mcpServers": {
  "snowflake_local": {
    "command": "/absolute/path/to/uv",
    "args": [
      "--python=3.12",  // Optional
      "--directory", "/absolute/path/to/mcp_snowflake_server",
      "run", "mcp_snowflake_server"
      // Optionally: "--allow_write"
      // Optionally: "--log_dir", "/absolute/path/to/logs"
      // Optionally: "--log_level", "DEBUG"/"INFO"/"WARNING"/"ERROR"/"CRITICAL"
      // Optionally: "--exclude_tools", "{tool_name}", ["{other_tool_name}"]
    ]
  }
}

Hinweise

Schreibvorgänge sind standardmäßig deaktiviert . Aktivieren Sie sie explizit mit --allow-write .
Der Server unterstützt das Herausfiltern bestimmter Datenbanken, Schemata oder Tabellen über Ausschlussmuster.
Wenn das Vorablesen aktiviert ist, stellt der Server zusätzliche Kontextressourcen pro Tabelle bereit.
Das Tool append_insight aktualisiert die Ressource memo://insights dynamisch.

Lizenz

MIT

mcp-snowflake-server