MCP.so
ログイン

mcp-server-mariadb-vector

@DavidRamosSal

mcp-server-mariadb-vector について

MCP server for MariaDB

基本情報

カテゴリ

データベース

ライセンス

LGPL-2.1 license

ランタイム

python

トランスポート

stdio

公開者

DavidRamosSal

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp-server-mariadb-vector": {
      "command": "uv",
      "args": [
        "run",
        "--dir",
        "path/to/mcp-server-mariadb-vector/",
        "--env-file",
        "path/to/mcp-server-mariadb-vector/.env",
        "mcp_server_mariadb_vector"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is mcp-server-mariadb-vector?

The mcp-server-mariadb-vector server provides tools that LLM agents can use to interact with a MariaDB database with vector support. It gives users a natural language interface to store and query data, and is compatible with any Model Context Protocol (MCP) client, such as Claude Desktop, Cursor, and Windsurf.

How to use mcp-server-mariadb-vector?

You need a running MariaDB instance (version 11.7 or higher) with vector support. Configure environment variables for database connection, embedding provider, and API key. Then run the server either as a Python package with uv or as a Docker container. Finally, add the server to your MCP client’s configuration file (e.g., claude_desktop_config.json) using the provided uv run command or SSE URL.

Key features of mcp-server-mariadb-vector

  • Create, delete, and list vector stores in MariaDB.
  • Add documents with optional metadata to a vector store.
  • Query a vector store using semantic search.
  • Uses OpenAI’s embedding models (e.g., text-embedding-3-small).
  • Works with any MCP-compatible client or framework.

Use cases of mcp-server-mariadb-vector

  • Provide contextual knowledge base to LLM agent conversations.
  • Store and retrieve conversation history with LLM agents.
  • Enable semantic search over personal or domain‑specific document collections.

FAQ from mcp-server-mariadb-vector

What MariaDB version is required?

MariaDB 11.7 or higher with vector support is required.

How can I run the server?

You can run the server using uv (Python package) or as a Docker container. Both methods are described in the README.

Which embedding provider is supported?

Currently, the server supports OpenAI embedding models. The default provider is openai and the default model is text-embedding-3-small.

How do I connect the server to Claude Desktop, Cursor, or Windsurf?

Add an entry for the server to the client’s MCP configuration file (e.g., claude_desktop_config.json) with the uv run command and a .env file, or use the SSE URL http://localhost:8000/sse if running as a Docker container.

What environment variables are required?

Required variables include MARIADB_HOST, MARIADB_PORT, MARIADB_USER, MARIADB_PASSWORD, MARIADB_DATABASE, EMBEDDING_PROVIDER, EMBEDDING_MODEL, and OPENAI_API_KEY. Defaults are provided for host (127.0.0.1), port (3306), provider (openai), and model (text-embedding-3-small).

コメント

「データベース」の他のコンテンツ