{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_d2mg9ax3sehz","handle":"mcp-db-server","url":"https://wellknown.network/agents/mcp-db-server","links":{"self":"https://wellknown.network/agents/mcp-db-server/record.json","html":"https://wellknown.network/agents/mcp-db-server","markdown":"https://wellknown.network/agents/mcp-db-server/record.md","api":"https://wellknown.network/api/v1/agents/mcp-db-server","status":"https://wellknown.network/api/v1/agents/mcp-db-server/status","claim":"https://wellknown.network/agents/mcp-db-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-db-server/claim.json","badge":"https://wellknown.network/agents/mcp-db-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-db-server/history","tools":"https://wellknown.network/api/v1/agents/mcp-db-server/tools"},"ard":{"identifier":"urn:air::server:mcp-db-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-db-server","summary":"MCP Database Server with read-only access","description":"# MCP Database Server\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server implementation in Python that provides **strictly read-only** access to databases. It allows Large Language Models (LLMs) to inspect schemas and query data safely without risking data modification.\n\n## Features\n\n- **🛡️ Strict Read-Only**: Enforced at the driver level (e.g., SQLite `?mode=ro`) or session level (MySQL `SET SESSION TRANSACTION READ ONLY`).\n- **🏗️ Repository Pattern**: Abstracted database access allows for easy extension to other backends (PostgreSQL, MySQL) via Dependency Injection.\n- **⚡ FastMCP**: Built efficiently using the official MCP Python SDK.\n- **🔌 Connection Pooling**: Automatic connection pooling for MySQL using `DBUtils` to ensure performance and reliability.\n- **🔧 Easy Configuration**: Managed via environment variables and Makefiles.\n\n## Project Structure\n\n- `mcp_db_server/`: Main Python package for the MCP server.\n  - `__init__.py`: Entry point and server initialization.\n  - `db/`: Repository implementations (`sqlite_repository.py`, `mysql_repository.py`).\n- `seed.py`: Utility script to populate the database (write access).\n- `Makefile`: Automation for common tasks.\n- `pyproject.toml`: Package configuration and dependencies.\n\n## Quick Start\n\n### Prerequisites\n- Python 3.12+ (managed via `venv`)\n- `make` (optional, but recommended)\n- MySQL Server (optional, if using MySQL backend)\n\n### 1. Setup\nUse the Makefile to create a virtual environment, install dependencies, and seed a test database:\n\n```bash\nmake setup\n```\n\n*This runs `pip install -r requirements.txt` and `python seed.py`.*\n\n### 2. Configuration\nThe project uses `python-dotenv`. Copy the example config and adjust as needed:\n\n```bash\ncp .env.example .env\n```\n\n**Key Variables:**\n- `DB_ENGINE`: `sqlite` (Default) or `mysql`\n- `DB_ADDRESS`: Path to db file (SQLite) or Host URL (MySQL).\n- `DB_PORT`: Database port (Default: 3306 for MySQL).\n- `DB_USER` / `DB_PASSWORD`: Database credentia…","publisher":null,"homepage":null,"repository":null,"version":"0.1.3","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-db-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"}],"categories":["data","dev"],"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":"mcp-db-server","registry":"pypi","observedAt":"2026-11-09T15:26:26.489Z","publishedAt":"2026-02-06T15:55:53.418734Z","latestVersion":"0.1.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-db-server","url":"https://pypi.org/project/mcp-db-server/","firstSeenAt":"2026-09-10T01:19:58.138Z","fetchedAt":"2026-11-09T15:24:29.719Z","normalizedAt":"2026-11-09T15:24:29.719Z"}]},"firstSeenAt":"2026-09-10T01:19:58.138Z","updatedAt":"2026-11-09T15:26:26.489Z"}