{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_jf5ma5nss9nf","handle":"iflow-mcp-mariadb-mariadb-server","url":"https://wellknown.network/agents/iflow-mcp-mariadb-mariadb-server","links":{"self":"https://wellknown.network/agents/iflow-mcp-mariadb-mariadb-server/record.json","html":"https://wellknown.network/agents/iflow-mcp-mariadb-mariadb-server","markdown":"https://wellknown.network/agents/iflow-mcp-mariadb-mariadb-server/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-mariadb-mariadb-server","status":"https://wellknown.network/api/v1/agents/iflow-mcp-mariadb-mariadb-server/status","claim":"https://wellknown.network/agents/iflow-mcp-mariadb-mariadb-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-mariadb-mariadb-server/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-mariadb-mariadb-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-mariadb-mariadb-server/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-mariadb-mariadb-server/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-mariadb-mariadb-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_mariadb-mariadb-server","summary":"MariaDB MCP Server","description":"# MCP MariaDB Server\n\nThe 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.\n\n---\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Core Components](#core-components)\n- [Available Tools](#available-tools)\n- [Embeddings & Vector Store](#embeddings--vector-store)\n- [Configuration & Environment Variables](#configuration--environment-variables)\n- [Installation & Setup](#installation--setup)\n- [Usage Examples](#usage-examples)\n- [Integration - Claude desktop/Cursor/Windsurf](#integration---claude-desktopcursorwindsurf)\n- [Logging](#logging)\n- [Testing](#testing)\n---\n\n## Overview\n\nThe MCP MariaDB Server exposes a set of tools for interacting with MariaDB databases and vector stores via a standardized protocol. It supports:\n- Listing databases and tables\n- Retrieving table schemas\n- Executing safe, read-only SQL queries\n- Creating and managing vector stores for embedding-based search\n- Integrating with embedding providers (currently OpenAI, Gemini, and HuggingFace) (optional)\n\n---\n\n## Core Components\n\n- **server.py**: Main MCP server logic and tool definitions.\n- **config.py**: Loads configuration from environment and `.env` files.\n- **embeddings.py**: Handles embedding service integration (OpenAI).\n- **tests/**: Manual and automated test documentation and scripts.\n\n---\n\n## Available Tools\n\n### Standard Database Tools\n\n- **list_databases**\n  - Lists all accessible databases.\n  - Parameters: _None_\n\n- **list_tables**\n  - Lists all tables in a specified database.\n  - Parameters: `database_name` (string, required)\n\n- **get_table_schema**\n  - Retrieves schema for a table (columns, types, keys, etc.).\n  - Parameters: `database_name` (string, required), `table_name` (string, required)\n\n- **get_table_s…","publisher":null,"homepage":null,"repository":null,"version":"0.2.4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_mariadb-mariadb-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"ai.model-access","name":"Model Access","confidence":0.905,"provenance":"derived"},{"slug":"data.vector-search","name":"Vector Search","confidence":0.825,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.768,"provenance":"derived"}],"categories":["ai","data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_mariadb-mariadb-server","registry":"pypi","observedAt":"2026-11-03T07:25:56.153Z","publishedAt":"2026-02-07T10:57:42.843227Z","latestVersion":"0.2.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_mariadb-mariadb-server","url":"https://pypi.org/project/iflow-mcp_mariadb-mariadb-server/","firstSeenAt":"2026-09-09T19:25:09.555Z","fetchedAt":"2026-11-03T07:24:34.476Z","normalizedAt":"2026-11-03T07:24:34.476Z"}]},"firstSeenAt":"2026-09-09T19:25:09.555Z","updatedAt":"2026-11-03T07:25:56.153Z"}