MMCPMarkets
MM

mariadb/mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

213 stars 91 forks Качество 85 Тренд 26MIT
Repository Install

Реализация сервера MariaDB MCP (Model Context Protocol)

Обзор

MCP MariaDB Server предоставляет интерфейс Model Context Protocol (MCP) для управления и запросов к базам данных MariaDB, поддерживая как стандартные SQL-операции, так и продвинутый поиск на основе векторов/вложения. Разработанный для использования с AI-ассистентами, он обеспечивает бесшовную интеграцию рабочих процессов с данными, управляемыми ИИ, с реляционными и векторными базами данных. MCP MariaDB Server предоставляет набор инструментов для взаимодействия с базами данных MariaDB и векторными хранилищами через стандартизированный протокол. Он поддерживает: - Перечисление баз данных и таблиц - Извлечение схем таблиц - Выполнение безопасных SQL-запросов только для чтения - Создание и управление векторными хранилищами для поиска на основе вложения - Интеграция с провайдерами встраивания (в настоящее время OpenAI, Gemini и HuggingFace) (опционально) - : Основная логика сервера MCP и определения инструментов. - : Загружает конфигурацию из файлов окружения и .env. - : Обрабатывает интеграцию встраиваемых сервисов (OpenAI). - : Ручная и автоматизированная документация тестов и скрипты. - - Перечисляет все доступные базы данных.

Обзор (машинный перевод)

MCP MariaDB Server предоставляет интерфейс Model Context Protocol (MCP) для управления и запросов к базам данных MariaDB, поддерживая как стандартные SQL-операции, так и продвинутый поиск на основе векторов/вложения. Разработанный для использования с AI-ассистентами, он обеспечивает бесшовную интеграцию рабочих процессов с данными, управляемыми ИИ, с реляционными и векторными базами данных.

Содержание

  • Обзор
  • Основные компоненты
  • Доступные инструменты
  • Вложения и векторное хранилище
  • Переменные конфигурации и среды
  • Вопросы безопасности
  • Установка и настройка
  • Примеры использования
  • Интеграция — Claude desktop/курсор/Windsurf
  • Лесозаготовка
  • Тестирование

Обзор

MCP MariaDB Server предоставляет набор инструментов для взаимодействия с базами данных MariaDB и векторными хранилищами через стандартизированный протокол. Он поддерживает:

  • Перечисление баз данных и таблиц
  • Извлечение схем таблиц
  • Выполнение безопасных SQL-запросов только для чтения
  • Создание и управление векторными хранилищами для поиска на основе вложения
  • Интеграция с провайдерами встраивания (в настоящее время OpenAI, Gemini и HuggingFace) (опционально)

Основные компоненты

  • server.py: Основная логика сервера MCP и определения инструментов.
  • config.py: Загружает конфигурацию из файлов окружения и .env.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

MCP MariaDB Server

The MCP MariaDB Server provides a Model Context Protocol (MCP) interface for managing and querying MariaDB databases, supporting both standard SQL operations and advanced vector/embedding-based search. Designed for use with AI assistants, it enables seamless integration of AI-driven data workflows with relational and vector databases.

Table of Contents

Overview

The MCP MariaDB Server exposes a set of tools for interacting with MariaDB databases and vector stores via a standardized protocol. It supports:

  • Listing databases and tables
  • Retrieving table schemas
  • Executing safe, read-only SQL queries
  • Creating and managing vector stores for embedding-based search
  • Integrating with embedding providers (currently OpenAI, Gemini, and HuggingFace) (optional)

Core Components

  • server.py: Main MCP server logic and tool definitions.
  • config.py: Loads configuration from environment and .env files.
  • embeddings.py: Handles embedding service integration (OpenAI).
  • tests/: Manual and automated test documentation and scripts.

Available Tools

Standard Database Tools

  • list_databases

    • Lists all accessible databases.
    • Parameters: None

  • list_tables

    • Lists all tables in a specified database.
    • Parameters: database_name (string, required)

  • get_table_schema

    • Retrieves schema for a table (columns, types, keys, etc.).
    • Parameters: database_name (string, required), table_name (string, required)

  • get_table_schema_with_relations

    • Retrieves schema with foreign key relations for a table.
    • Parameters: database_name (string, required), table_name (string, required)

  • execute_sql

    • Executes a read-only SQL query (SELECT, SHOW, DESCRIBE).
    • Parameters: sql_query (string, required), database_name (string, optional), parameters (list, optional)
    • Note: Enforces read-only mode if MCP_READ_ONLY is enabled.

  • create_database

    • Creates a new database if it doesn’t exist.
    • Parameters: database_name (string, required)

Vector Store & Embedding Tools (optional)

Note: These tools are only available when EMBEDDING_PROVIDER is configured. If no embedding provider is set, these tools will be disabled.

  • create_vector_store
    • Creates a new vector store (table) for embeddings.
Открыть полный README на GitHub

Установка

docker run -i --rm -p 9001:9001 -e DB_HOST= -e DB_PORT= -e DB_USER= -e DB_PASSWORD= -e DB_NAME= mariadb-mcp-server python src/server.py --host 0.0.0.0 --transport stdio
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "MariaDB_Server": { "command": "uv", "args": [ "--directory", "path/to/mariadb-mcp-server/", "run", "server.py" ], "envFile": "path/to/mcp-server-mariadb-vector/.env" } } }