{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_pzp5wnndpy2c","handle":"db-query-mcp","url":"https://wellknown.network/agents/db-query-mcp","links":{"self":"https://wellknown.network/agents/db-query-mcp/record.json","html":"https://wellknown.network/agents/db-query-mcp","markdown":"https://wellknown.network/agents/db-query-mcp/record.md","api":"https://wellknown.network/api/v1/agents/db-query-mcp","status":"https://wellknown.network/api/v1/agents/db-query-mcp/status","claim":"https://wellknown.network/agents/db-query-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/db-query-mcp/claim.json","badge":"https://wellknown.network/agents/db-query-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/db-query-mcp/history","tools":"https://wellknown.network/api/v1/agents/db-query-mcp/tools"},"ard":{"identifier":"urn:air::server:db-query-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"db-query-mcp","summary":"db-query-mcp is an MCP tool that enables data querying and export operations across diverse databases.","description":"![image](logo.png)\n\n![Python Version](https://img.shields.io/badge/python-3.10+-aff.svg)\n![License](https://img.shields.io/badge/license-Apache%202-dfd.svg)\n[![PyPI](https://img.shields.io/pypi/v/db-query-mcp)](https://pypi.org/project/db-query-mcp/)\n[![GitHub pull request](https://img.shields.io/badge/PRs-welcome-blue)](https://github.com/Shulin-Zhang/db-query-mcp/pulls)\n\n[ English | [中文](README_ZH.md) ]\n\n# db-query-mcp\n\n## Introduction\ndb-query-mcp is a mcp tool supporting diverse database querying and exporting, featuring:\n\n- **Multi-DB Support**: Full compatibility with mainstream databases (ElasticSearch, MySQL, PostgreSQL, Oracle, SQLite, etc.)\n- **Secure Access**: Default read-only mode for data protection\n- **Smart Query**: Natural language to SQL conversion with query optimization\n- **Data Export**: CSV / Json export capabilities\n- **Roadmap**: Expanding support for MongoDB and GraphDatabase to become full-stack DB query MCP\n\n## Demo\nhttps://github.com/user-attachments/assets/60771cda-8b52-41bd-90e3-523c836f6366\n\n## Changelog\n\n- 2025-06-02: Added support for ElasticSearch database queries\n\n## Installation\n\n```bash\npip install db-query-mcp\n```\n\nElasticSearch:\n```bash\npip install \"db-query-mcp[elasticsearch]\"\n```\n\nInstall from GitHub:\n```bash\npip install git+https://github.com/NewToolAI/db-query-mcp\n```\n\n**MySQL requires additional dependencies:**\n```bash\npip install pymysql\n```\n\n**PostgreSQL requires additional dependencies:**\n```bash\npip install psycopg2-binary\n```\n\n**For other databases, install their respective connection packages:**\n\n| Database    | Connection Package       | Example Connection String |\n|-------------|--------------------------|---------------------------|\n| **SQLite**  | Built-in Python          | `sqlite:///example.db`    |\n| **MySQL**   | `pymysql` or `mysql-connector-python` | `mysql+pymysql://user:password@localhost/dbname` |\n| **PostgreSQL** | `psycopg2` or `psycopg2-binary` | `postgresql://user:password@localhost:5432/dbname` |\n|…","publisher":null,"homepage":null,"repository":"https://github.com/NewToolAI/db-query-mcp","version":"0.0.7","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:db-query-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":1,"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":"db-query-mcp","registry":"pypi","observedAt":"2026-11-09T03:24:26.691Z","publishedAt":"2025-06-14T03:17:42.143319Z","latestVersion":"0.0.7"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"db-query-mcp","url":"https://pypi.org/project/db-query-mcp/","firstSeenAt":"2026-09-09T13:21:47.849Z","fetchedAt":"2026-11-09T03:23:00.043Z","normalizedAt":"2026-11-09T03:23:00.043Z"}]},"firstSeenAt":"2026-09-09T13:21:47.849Z","updatedAt":"2026-11-09T03:24:26.691Z"}