{"_id":"@database-mcp/libsql","_rev":"6-cb08234d5affdba702227d6e964d00cf","name":"@database-mcp/libsql","dist-tags":{"latest":"0.4.2"},"versions":{"0.0.0":{"name":"@database-mcp/libsql","version":"0.0.0","keywords":["mcp","model-context-protocol","libsql","turso","database","sql"],"license":"MIT","_id":"@database-mcp/libsql@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":"29dc328f682d74f879cab7a9ae3c0d36cfa9c860","tarball":"https://registry.npmjs.org/@database-mcp/libsql/-/libsql-0.0.0.tgz","fileCount":2,"integrity":"sha512-68sCrTmG5WCUb8pR6nt6OVTwmmnZ9y6oX64useXmpw5tQovQvG5jJCCmE8lrgITlKfQoZ+CJI0V9t85WrsQBlA==","signatures":[{"sig":"MEQCIF+xGWXupugMR1jWqEZS/7vd8Zhc6iaMQWLyLRL3U4NiAiApokzvnZpLpglvxc8bBaZ2LqJsyIdOnrwgEndvRea+JA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":958},"_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 libSQL/Turso 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/libsql_0.0.0_1783841436395_0.024551437261990605","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@database-mcp/libsql","version":"0.2.0","keywords":["mcp","model-context-protocol","libsql","turso","sqlite","database","sql"],"license":"MIT","_id":"@database-mcp/libsql@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-libsql":"dist/index.js"},"dist":{"shasum":"4bcfba4fb2f2c3feb23e4ad9f6fdd0cad3848e7c","tarball":"https://registry.npmjs.org/@database-mcp/libsql/-/libsql-0.2.0.tgz","fileCount":8,"integrity":"sha512-9irisVGAyzmmeQI6ehNf4GHjKtDTog9siqEQKksCDdLDCa88FuOqLSmLCf5u+ghprEsqJ+XozGxutE0p3Z652w==","signatures":[{"sig":"MEUCIQCRDtOiD7slJGhHoQIh1J58n4jxUofD9sUCSKk1S6w4VwIgGDWjKIFFBninzjQ95ZKYm8xCqEpHcpqPpVdmFGoNQ4Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2flibsql@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":15687},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"4e233811a4acc3c1341a291c1778e365e4fcbb02","scripts":{"build":"tsc"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7e9b94fe-2e53-4c43-9c05-55abc6dee342"}},"repository":{"url":"git+https://github.com/arifulislamat/database-mcp.git","type":"git","directory":"libsql/typescript"},"_npmVersion":"12.0.1","description":"MCP server for libSQL/Turso (local files and remote databases) with read-only guardrails, row caps, and statement timeouts","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@libsql/client":"^0.17.4","@database-mcp/core":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/libsql_0.2.0_1783841609241_0.1685496096050434","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@database-mcp/libsql","version":"0.3.0","keywords":["mcp","model-context-protocol","libsql","turso","sqlite","database","sql"],"license":"MIT","_id":"@database-mcp/libsql@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-libsql":"dist/index.js"},"dist":{"shasum":"1fed3ab582906a4299a53f1344aa48562ae2fb09","tarball":"https://registry.npmjs.org/@database-mcp/libsql/-/libsql-0.3.0.tgz","fileCount":8,"integrity":"sha512-laJP/ZuH+enZG2pfXulYfHHNvKmTDUMeHm0SVuyIU07O+4MqhK/y4BfJp4UKXjl5/AQttl6Nc3ir+3dRnFFwFA==","signatures":[{"sig":"MEUCICkkKUBip/DPNU+T0nW71uZx0/Vm18RnGrl+7bNytkptAiEA4lKaTsV8okm/VeySCS+m++YedHBQWVTbvH4aUP+UczE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2flibsql@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":16875},"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:7e9b94fe-2e53-4c43-9c05-55abc6dee342"}},"repository":{"url":"git+https://github.com/arifulislamat/database-mcp.git","type":"git","directory":"libsql/typescript"},"_npmVersion":"12.0.1","description":"MCP server for libSQL/Turso (local files and remote databases) with read-only guardrails, row caps, and statement timeouts","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@libsql/client":"^0.17.4","@database-mcp/core":"^0.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/libsql_0.3.0_1783857140958_0.4948069910095716","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@database-mcp/libsql","version":"0.4.0","keywords":["mcp","model-context-protocol","libsql","turso","sqlite","database","sql"],"license":"MIT","_id":"@database-mcp/libsql@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-libsql":"dist/index.js"},"dist":{"shasum":"8c77ad019e5be2c33805e4234165e1ac4240a18d","tarball":"https://registry.npmjs.org/@database-mcp/libsql/-/libsql-0.4.0.tgz","fileCount":8,"integrity":"sha512-9pvHyG69fcJjvWMRHUwGRjZyt2CITtRxuJvI0e83+At4U/NWCZPLjAzkYJhprcoGN9nTaLqMAxUkMvjmCYwCfA==","signatures":[{"sig":"MEUCIQDRAmfHypoGqzvDmy/xFsYJihjR1cYI4l2NQCvC7XL9wwIgFa4vDTHIcCSw6xcGhkIUkKd+VOjkE9KY97UQPfqEAlQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2flibsql@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":17281},"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:7e9b94fe-2e53-4c43-9c05-55abc6dee342"}},"repository":{"url":"git+https://github.com/arifulislamat/database-mcp.git","type":"git","directory":"libsql/typescript"},"_npmVersion":"12.0.1","description":"MCP server for libSQL/Turso (local files and remote databases) with read-only guardrails, row caps, and statement timeouts","directories":{},"_nodeVersion":"24.18.0","dependencies":{"@libsql/client":"^0.17.4","@database-mcp/core":"^0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^7.0.2","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/libsql_0.4.0_1783859769508_0.759765053351078","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@database-mcp/libsql","version":"0.4.1","keywords":["mcp","model-context-protocol","libsql","turso","sqlite","database","sql"],"license":"MIT","_id":"@database-mcp/libsql@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-libsql":"dist/index.js"},"dist":{"shasum":"5be8aa42e0a2eef4727ee88294139fe697207f91","tarball":"https://registry.npmjs.org/@database-mcp/libsql/-/libsql-0.4.1.tgz","fileCount":8,"integrity":"sha512-pHUYHk3K3WAh5sWs+Giuxk4o8Y7BAYUHPgDhxF1irDOAwaOQzWNs06bMVuS8cPANronX7nRN8WOQmE2K88pZ9w==","signatures":[{"sig":"MEUCIE/ahoOzVb2gvrqz5/0P62gpORwCe12k8XZe7GEYNsu4AiEAmYAIpPwM63w5XQ4EJPvuSzDZdK6jydOpsb9M8KUIq6c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2flibsql@0.4.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":17341},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=22"},"gitHead":"cf712fad4491b7007a6b96170c15cf718d7e6068","mcpName":"io.github.arifulislamat/database-mcp-libsql","scripts":{"build":"tsc"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7e9b94fe-2e53-4c43-9c05-55abc6dee342"}},"repository":{"url":"git+https://github.com/arifulislamat/database-mcp.git","type":"git","directory":"libsql/typescript"},"_npmVersion":"12.0.1","description":"MCP server for libSQL/Turso (local files and remote databases) with read-only guardrails, row caps, and statement timeouts","directories":{},"_nodeVersion":"24.18.0","dependencies":{"@libsql/client":"^0.17.4","@database-mcp/core":"^0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^7.0.2","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/libsql_0.4.1_1783861531748_0.4156664637984049","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@database-mcp/libsql","version":"0.4.2","description":"MCP server for libSQL/Turso (local files and remote databases) 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-libsql":"dist/index.js"},"scripts":{"build":"tsc"},"repository":{"type":"git","url":"git+https://github.com/arifulislamat/database-mcp.git","directory":"libsql/typescript"},"homepage":"https://github.com/arifulislamat/database-mcp#readme","keywords":["mcp","model-context-protocol","libsql","turso","sqlite","database","sql"],"dependencies":{"@database-mcp/core":"^0.4.0","@libsql/client":"^0.17.4"},"devDependencies":{"@types/node":"^24.0.0","typescript":"^7.0.2"},"engines":{"node":">=22"},"publishConfig":{"access":"public"},"mcpName":"io.github.arifulislamat/database-mcp-libsql","gitHead":"a2ee8adb85265281b0097981059c2a0ce00b64a8","_id":"@database-mcp/libsql@0.4.2","bugs":{"url":"https://github.com/arifulislamat/database-mcp/issues"},"_nodeVersion":"24.18.0","_npmVersion":"12.0.1","dist":{"integrity":"sha512-uuhKdJ0GcRa2VXuDDwToenikqRZsTh6YsKJ6xbumffx9pkE+8Qh+LCF65YKvvgfMDSoSLmtv89ZZ6mUtPXCLsg==","shasum":"06094a52f6d054b34919888b20fc0edb1592da22","tarball":"https://registry.npmjs.org/@database-mcp/libsql/-/libsql-0.4.2.tgz","fileCount":8,"unpackedSize":17341,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@database-mcp%2flibsql@0.4.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCr8ecLNz1ecpt/WkrVcAhl1rtBzK8LgeUuPFpwMrgr5wIhAO+t20NHsHWOU398hZa1bY1IYFc/ml/s8TGcE9R2W/KE"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7e9b94fe-2e53-4c43-9c05-55abc6dee342"}},"directories":{},"maintainers":[{"name":"arifulislamat","email":"arifulislamat@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/libsql_0.4.2_1784227047985_0.971335255889427"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-12T07:30:36.193Z","modified":"2026-07-16T18:37:28.459Z","0.0.0":"2026-07-12T07:30:36.519Z","0.2.0":"2026-07-12T07:33:29.372Z","0.3.0":"2026-07-12T11:52:21.107Z","0.4.0":"2026-07-12T12:36:09.649Z","0.4.1":"2026-07-12T13:05:31.890Z","0.4.2":"2026-07-16T18:37:28.125Z"},"bugs":{"url":"https://github.com/arifulislamat/database-mcp/issues"},"license":"MIT","homepage":"https://github.com/arifulislamat/database-mcp#readme","keywords":["mcp","model-context-protocol","libsql","turso","sqlite","database","sql"],"repository":{"type":"git","url":"git+https://github.com/arifulislamat/database-mcp.git","directory":"libsql/typescript"},"description":"MCP server for libSQL/Turso (local files and remote databases) with read-only guardrails, row caps, and statement timeouts","maintainers":[{"name":"arifulislamat","email":"arifulislamat@gmail.com"}],"readme":"# @database-mcp/libsql\n\n[![npm](https://img.shields.io/npm/v/%40database-mcp%2Flibsql)](https://www.npmjs.com/package/@database-mcp/libsql) [![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 libSQL database,\neither a local file or a remote server (Turso / sqld). Two tools, guardrails\non by default.\n\n## Quick start (Claude Desktop / Claude Code / Cursor)\n\nRemote database with an auth token:\n\n```json\n{\n  \"mcpServers\": {\n    \"libsql\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@database-mcp/libsql\", \"--dsn\", \"libsql://your-db.turso.io\"],\n      \"env\": { \"LIBSQL_AUTH_TOKEN\": \"your-token\" }\n    }\n  }\n}\n```\n\nLocal file, no token needed:\n\n```json\n\"args\": [\"-y\", \"@database-mcp/libsql\", \"--dsn\", \"/absolute/path/to/database.db\"]\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`LIBSQL_URL` for the database and `LIBSQL_AUTH_TOKEN` for the token:\n\n```json\n\"env\": {\n  \"LIBSQL_URL\": \"libsql://your-db.turso.io\",\n  \"LIBSQL_AUTH_TOKEN\": \"your-token\"\n}\n```\n\n### Mounted secret file (Docker, Kubernetes)\n\nKeeps the token out of the environment and out of every config file. Point\n`LIBSQL_AUTH_TOKEN_FILE` at a file that contains only the token:\n\n```json\n\"env\": {\n  \"LIBSQL_URL\": \"libsql://your-db.turso.io\",\n  \"LIBSQL_AUTH_TOKEN_FILE\": \"/run/secrets/libsql_token\"\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. The token goes in the\n`password` field:\n\n```json\n\"args\": [\"-y\", \"@database-mcp/libsql\", \"--config\", \"/absolute/path/database-mcp.yaml\"]\n```\n\n```yaml\n# /absolute/path/database-mcp.yaml\nconnection:\n  dsn: libsql://your-db.turso.io\n  password: ${LIBSQL_AUTH_TOKEN} # expanded from the environment at load time\n  # or read it from a mounted file instead:\n  # password_file: /run/secrets/libsql_token\n\nguardrails:\n  readOnly: true\n  maxRows: 1000\n  queryTimeoutMs: 30000\n```\n\nNever write a literal token into the YAML file. Use `${VAR}` expansion or\n`password_file` as shown.\n\n### Checking the result\n\nRun the server with `--print-config` to see exactly what it resolved. The\ntoken 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\nThe SQL guard blocks mutating statements, and local files additionally\nenforce `PRAGMA query_only`. Remote servers may not honor per-session\npragmas, so for hard protection connect with a read-only auth token. Turso\nsupports these natively.\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"}