{"_id":"@database-mcp/mariadb","_rev":"6-982171977545886594e726eedc13df4e","name":"@database-mcp/mariadb","dist-tags":{"latest":"0.4.2"},"versions":{"0.0.0":{"name":"@database-mcp/mariadb","version":"0.0.0","keywords":["mcp","model-context-protocol","mariadb","database","sql"],"license":"MIT","_id":"@database-mcp/mariadb@0.0.0","maintainers":[{"name":"arifulislamat","email":"arifulislamat@gmail.com"}],"homepage":"https://github.com/arifulislamat/database-mcp#readme","bugs":{"url":"https://github.com/arifulislamat/database-mcp/issues"},"dist":{"shasum":"506e70d9a696d5df6ba36c9b75a19553338bb209","tarball":"https://registry.npmjs.org/@database-mcp/mariadb/-/mariadb-0.0.0.tgz","fileCount":2,"integrity":"sha512-Ir/1u3jQNq4mpXfLfCUgmNEMgmSg7vIGJ8x58iukeh4iwpkGJgNsCsyZh4Gglf4sxslgBvMHCQroqnl+oxlfRA==","signatures":[{"sig":"MEUCIQCQgNsxwYXzvq0UkNIZEFYrh+apL4raYd86VFNMnCpxjwIgAmYo454AEcpmt7SE0it/BT4o78IezyXCzKUEEvK3tfk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":907},"_npmUser":{"name":"arifulislamat","email":"arifulislamat@gmail.com"},"repository":{"url":"git+https://github.com/arifulislamat/database-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for MariaDB with read-only guardrails, row caps, and statement timeouts. Placeholder — real release imminent.","directories":{},"_nodeVersion":"22.13.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mariadb_0.0.0_1783846617055_0.9518748072286598","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@database-mcp/mariadb","version":"0.2.0","keywords":["mcp","model-context-protocol","mariadb","mysql","database","sql"],"license":"MIT","_id":"@database-mcp/mariadb@0.2.0","maintainers":[{"name":"arifulislamat","email":"arifulislamat@gmail.com"}],"homepage":"https://github.com/arifulislamat/database-mcp#readme","bugs":{"url":"https://github.com/arifulislamat/database-mcp/issues"},"bin":{"database-mcp-mariadb":"dist/index.js"},"dist":{"shasum":"a5e14033c5b60b395e242bbbd97ef34949448ce6","tarball":"https://registry.npmjs.org/@database-mcp/mariadb/-/mariadb-0.2.0.tgz","fileCount":8,"integrity":"sha512-zhBicY2347MgFV7fPbRzPb9/NPoGnJsJQFRdR+k9Hji26UfNeywZmRm8lon1JU6gbLbNyAlda8LesrWR9d/hDg==","signatures":[{"sig":"MEYCIQDiE4ccKRXGiByB8z4pcor0A4fMPS/Csg82xpJej9b5hQIhAL+rUDsBwCbBGvolYS+kkt0GoGWFQP/MpsM9nJADew1T","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2fmariadb@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":5549},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"8b9beb6818e16d55d1829d0af27968ddb2316325","scripts":{"build":"tsc"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:df646114-bfbb-4bba-b621-068e0b0825e7"}},"repository":{"url":"git+https://github.com/arifulislamat/database-mcp.git","type":"git","directory":"mariadb/typescript"},"_npmVersion":"12.0.1","description":"MCP server for MariaDB with read-only guardrails, row caps, and statement timeouts","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@database-mcp/core":"^0.2.1","@database-mcp/mysql":"^0.2.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mariadb_0.2.0_1783846788680_0.9992052210499778","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@database-mcp/mariadb","version":"0.3.0","keywords":["mcp","model-context-protocol","mariadb","mysql","database","sql"],"license":"MIT","_id":"@database-mcp/mariadb@0.3.0","maintainers":[{"name":"arifulislamat","email":"arifulislamat@gmail.com"}],"homepage":"https://github.com/arifulislamat/database-mcp#readme","bugs":{"url":"https://github.com/arifulislamat/database-mcp/issues"},"bin":{"database-mcp-mariadb":"dist/index.js"},"dist":{"shasum":"24ebacde2fd22db3e3ffe82e85d1bbeff4ce2565","tarball":"https://registry.npmjs.org/@database-mcp/mariadb/-/mariadb-0.3.0.tgz","fileCount":8,"integrity":"sha512-dFTfPAnFPUXHJMvfwmnPDe7Yt68Az0j0saZHrQmgBi1LUp9NUHln4k4q+saherb7SJfr5DHabwmVvdsx1tneNg==","signatures":[{"sig":"MEUCICn/wA4MzMjkCC7H8DdwIncLDsh7TJEOUnxGOUg34SiZAiEAp4kbjNYtMxpEXaRqb1rVBG2mdDC8PZT3k7PnDqOQTf0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2fmariadb@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":7161},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"8fb24f27be60dc9fc5167dcf1df253dece021368","scripts":{"build":"tsc"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:df646114-bfbb-4bba-b621-068e0b0825e7"}},"repository":{"url":"git+https://github.com/arifulislamat/database-mcp.git","type":"git","directory":"mariadb/typescript"},"_npmVersion":"12.0.1","description":"MCP server for MariaDB with read-only guardrails, row caps, and statement timeouts","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@database-mcp/core":"^0.3.0","@database-mcp/mysql":"^0.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mariadb_0.3.0_1783857155012_0.8265212309266663","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@database-mcp/mariadb","version":"0.4.0","keywords":["mcp","model-context-protocol","mariadb","mysql","database","sql"],"license":"MIT","_id":"@database-mcp/mariadb@0.4.0","maintainers":[{"name":"arifulislamat","email":"arifulislamat@gmail.com"}],"homepage":"https://github.com/arifulislamat/database-mcp#readme","bugs":{"url":"https://github.com/arifulislamat/database-mcp/issues"},"bin":{"database-mcp-mariadb":"dist/index.js"},"dist":{"shasum":"6511825d864d7b1538716a2ef410f8cc0ced3156","tarball":"https://registry.npmjs.org/@database-mcp/mariadb/-/mariadb-0.4.0.tgz","fileCount":8,"integrity":"sha512-OdxnR+vkrckACkHs+STHkimKuBqEUOqMLFF0sNyUd0xlVStdxKcVCCw99DCgJxdTSw7wXYo2u1ycdlqT8MZ8BQ==","signatures":[{"sig":"MEUCIQCSlrdJuI0inpXMSCX8H5ailBntVgYTpGgYZ+IZEew88AIgTnRX2Is27LwWDfigI2wFeC6l7dnMHoty0j8pvEP1BSo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2fmariadb@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":7586},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=22"},"gitHead":"5ed6461b30f629f6d672096c28ffbaab1e43c2bf","scripts":{"build":"tsc"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:df646114-bfbb-4bba-b621-068e0b0825e7"}},"repository":{"url":"git+https://github.com/arifulislamat/database-mcp.git","type":"git","directory":"mariadb/typescript"},"_npmVersion":"12.0.1","description":"MCP server for MariaDB with read-only guardrails, row caps, and statement timeouts","directories":{},"_nodeVersion":"24.18.0","dependencies":{"@database-mcp/core":"^0.4.0","@database-mcp/mysql":"^0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^7.0.2","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mariadb_0.4.0_1783859839904_0.28757114136635376","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@database-mcp/mariadb","version":"0.4.1","keywords":["mcp","model-context-protocol","mariadb","mysql","database","sql"],"license":"MIT","_id":"@database-mcp/mariadb@0.4.1","maintainers":[{"name":"arifulislamat","email":"arifulislamat@gmail.com"}],"homepage":"https://github.com/arifulislamat/database-mcp#readme","bugs":{"url":"https://github.com/arifulislamat/database-mcp/issues"},"bin":{"database-mcp-mariadb":"dist/index.js"},"dist":{"shasum":"11a26c2c504ecb6d7ec0d76bbf9b61feaad4f1a9","tarball":"https://registry.npmjs.org/@database-mcp/mariadb/-/mariadb-0.4.1.tgz","fileCount":8,"integrity":"sha512-B7KjEoG0AQczlpuJNXcJNKCRlFQ+d27Ol+46wi5uUEDM44GFczUEE8yaAIBvlqHSNSvJF+X1POS6aJwFHSgMaA==","signatures":[{"sig":"MEUCIFNpqmGlkxgE7ZYoqV9ugOB/lFkyIsWXpVFa9SDmzRS+AiEArUmuEPh35u47HLmOzJYAvljp+3/SeLi2kIgzXLBWBSU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2fmariadb@0.4.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":7647},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=22"},"gitHead":"cf712fad4491b7007a6b96170c15cf718d7e6068","mcpName":"io.github.arifulislamat/database-mcp-mariadb","scripts":{"build":"tsc"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:df646114-bfbb-4bba-b621-068e0b0825e7"}},"repository":{"url":"git+https://github.com/arifulislamat/database-mcp.git","type":"git","directory":"mariadb/typescript"},"_npmVersion":"12.0.1","description":"MCP server for MariaDB with read-only guardrails, row caps, and statement timeouts","directories":{},"_nodeVersion":"24.18.0","dependencies":{"@database-mcp/core":"^0.4.0","@database-mcp/mysql":"^0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^7.0.2","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mariadb_0.4.1_1783861619801_0.9875272493108513","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@database-mcp/mariadb","version":"0.4.2","description":"MCP server for MariaDB with read-only guardrails, row caps, and statement timeouts","license":"MIT","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"database-mcp-mariadb":"dist/index.js"},"scripts":{"build":"tsc"},"repository":{"type":"git","url":"git+https://github.com/arifulislamat/database-mcp.git","directory":"mariadb/typescript"},"homepage":"https://github.com/arifulislamat/database-mcp#readme","keywords":["mcp","model-context-protocol","mariadb","mysql","database","sql"],"dependencies":{"@database-mcp/core":"^0.4.0","@database-mcp/mysql":"^0.4.0"},"devDependencies":{"@types/node":"^24.0.0","typescript":"^7.0.2"},"engines":{"node":">=22"},"publishConfig":{"access":"public"},"mcpName":"io.github.arifulislamat/database-mcp-mariadb","gitHead":"a2ee8adb85265281b0097981059c2a0ce00b64a8","_id":"@database-mcp/mariadb@0.4.2","bugs":{"url":"https://github.com/arifulislamat/database-mcp/issues"},"_nodeVersion":"24.18.0","_npmVersion":"12.0.1","dist":{"integrity":"sha512-/C8+6SPzZkdUWfXqo66/9Esit9abHDu/NvowRoOF6izQ0ay9VJzt0vrLKMuuqGr9hQsp6pWlHuu+mPtVH/Suew==","shasum":"4f98b3f7e6f6ead7296da0b43cb65c1ff5fc42fc","tarball":"https://registry.npmjs.org/@database-mcp/mariadb/-/mariadb-0.4.2.tgz","fileCount":8,"unpackedSize":7647,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2fmariadb@0.4.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICLy2vX+WElUJfYbwA/3z1JvIerV17kJG1C+YjHXcazGAiAqu0T/G2+weyqgk1E9xPAcHmS1YvWtkXEmFsxzuUBKnw=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:df646114-bfbb-4bba-b621-068e0b0825e7"}},"directories":{},"maintainers":[{"name":"arifulislamat","email":"arifulislamat@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mariadb_0.4.2_1784227155856_0.7428092049484523"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-12T08:56:56.832Z","modified":"2026-07-16T18:39:16.332Z","0.0.0":"2026-07-12T08:56:57.168Z","0.2.0":"2026-07-12T08:59:48.844Z","0.3.0":"2026-07-12T11:52:35.145Z","0.4.0":"2026-07-12T12:37:20.047Z","0.4.1":"2026-07-12T13:06:59.972Z","0.4.2":"2026-07-16T18:39:16.019Z"},"bugs":{"url":"https://github.com/arifulislamat/database-mcp/issues"},"license":"MIT","homepage":"https://github.com/arifulislamat/database-mcp#readme","keywords":["mcp","model-context-protocol","mariadb","mysql","database","sql"],"repository":{"type":"git","url":"git+https://github.com/arifulislamat/database-mcp.git","directory":"mariadb/typescript"},"description":"MCP server for MariaDB with read-only guardrails, row caps, and statement timeouts","maintainers":[{"name":"arifulislamat","email":"arifulislamat@gmail.com"}],"readme":"# @database-mcp/mariadb\n\n[![npm](https://img.shields.io/npm/v/%40database-mcp%2Fmariadb)](https://www.npmjs.com/package/@database-mcp/mariadb) [![CI](https://github.com/arifulislamat/database-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/arifulislamat/database-mcp/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/github/license/arifulislamat/database-mcp)](https://github.com/arifulislamat/database-mcp/blob/main/LICENSE)\n\nMCP server giving AI clients safe, structured access to a MariaDB database.\nTwo tools, guardrails on by default. MariaDB is MySQL wire-compatible, so\nthis is a thin package over the\n[`@database-mcp/mysql`](https://www.npmjs.com/package/@database-mcp/mysql)\nadapter with MariaDB-flavored configuration.\n\n## Quick start (Claude Desktop / Claude Code / Cursor)\n\n```json\n{\n  \"mcpServers\": {\n    \"mariadb\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@database-mcp/mariadb\"],\n      \"env\": {\n        \"MARIADB_HOST\": \"127.0.0.1\",\n        \"MARIADB_USER\": \"readonly_user\",\n        \"MARIADB_PASSWORD\": \"your-password\",\n        \"MARIADB_DATABASE\": \"mydb\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\nUse whichever method fits your setup. When methods are combined, flags win\nover the YAML file, and the YAML file wins over environment variables.\n\n### Environment variables\n\n`MARIADB_HOST`, `MARIADB_PORT`, `MARIADB_USER`, `MARIADB_PASSWORD`,\n`MARIADB_DATABASE`, as in the quick start above.\n\n### Mounted secret file (Docker, Kubernetes)\n\nKeeps the password out of the environment and out of every config file.\nPoint `MARIADB_PASSWORD_FILE` at a file that contains only the password:\n\n```json\n\"env\": {\n  \"MARIADB_HOST\": \"127.0.0.1\",\n  \"MARIADB_USER\": \"readonly_user\",\n  \"MARIADB_PASSWORD_FILE\": \"/run/secrets/mariadb_password\",\n  \"MARIADB_DATABASE\": \"mydb\"\n}\n```\n\n### YAML config file\n\nKeeps the client entry down to two lines. Pass an absolute path, since the\nworking directory at launch is unpredictable:\n\n```json\n\"args\": [\"-y\", \"@database-mcp/mariadb\", \"--config\", \"/absolute/path/database-mcp.yaml\"]\n```\n\n```yaml\n# /absolute/path/database-mcp.yaml\nconnection:\n  host: 127.0.0.1\n  port: 3306\n  user: readonly_user\n  password: ${MARIADB_PASSWORD} # expanded from the environment at load time\n  # or read it from a mounted file instead:\n  # password_file: /run/secrets/mariadb_password\n  database: mydb\n\nguardrails:\n  readOnly: true\n  maxRows: 1000\n  queryTimeoutMs: 30000\n```\n\nNever write a literal password into the YAML file. Use `${VAR}` expansion or\n`password_file` as shown.\n\n### Connection string\n\n```json\n\"args\": [\"-y\", \"@database-mcp/mariadb\", \"--dsn\", \"mysql://readonly_user@127.0.0.1:3306/mydb\"]\n```\n\nMariaDB uses the MySQL URI scheme. Putting the password inside the DSN works\nbut is discouraged. If you do it anyway, the server redacts it from any log\noutput.\n\n### Checking the result\n\nRun the server with `--print-config` to see exactly what it resolved. The\npassword always prints as `***`.\n\n## Tools\n\n- **`execute_sql`** `{ sql }` runs a single SQL statement.\n- **`search_objects`** `{ table? }` lists tables, or describes one (columns,\n  indexes, foreign keys).\n\n## Guardrails (defaults)\n\n| Guardrail     | Default  | Override                                  |\n| ------------- | -------- | ----------------------------------------- |\n| Read-only     | on       | `--allow-write` / `ALLOW_WRITE`           |\n| Row cap       | 1000     | `--max-rows` / `MAX_ROWS`                 |\n| Query timeout | 30000 ms | `--query-timeout-ms` / `QUERY_TIMEOUT_MS` |\n\nRead-only is enforced in two layers: a conservative SQL guard, plus\n`SET SESSION TRANSACTION READ ONLY` on every pooled connection.\n\n## Part of database-mcp\n\nOne package per engine, identical tool contract, shared conformance suite:\n[github.com/arifulislamat/database-mcp](https://github.com/arifulislamat/database-mcp)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}