{"id":26237146,"url":"https://github.com/nbbaier/mcp-turso","last_synced_at":"2026-04-21T23:04:22.996Z","repository":{"id":281595835,"uuid":"945753194","full_name":"nbbaier/mcp-turso","owner":"nbbaier","description":"MCP server for interacting with Turso-hosted LibSQL databases","archived":false,"fork":false,"pushed_at":"2025-11-03T02:36:11.000Z","size":84,"stargazers_count":6,"open_issues_count":4,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-31T15:02:28.448Z","etag":null,"topics":["ai","libsql","mcp","mcp-server","model-context-protocol","sql","sqlite","turso"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nbbaier.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-10T04:22:01.000Z","updated_at":"2025-12-14T07:39:26.000Z","dependencies_parsed_at":"2026-01-03T11:08:56.808Z","dependency_job_id":null,"html_url":"https://github.com/nbbaier/mcp-turso","commit_stats":null,"previous_names":["nbbaier/mcp-turso"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nbbaier/mcp-turso","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nbbaier%2Fmcp-turso","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nbbaier%2Fmcp-turso/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nbbaier%2Fmcp-turso/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nbbaier%2Fmcp-turso/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nbbaier","download_url":"https://codeload.github.com/nbbaier/mcp-turso/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nbbaier%2Fmcp-turso/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32113748,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T11:25:29.218Z","status":"ssl_error","status_checked_at":"2026-04-21T11:25:28.499Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","libsql","mcp","mcp-server","model-context-protocol","sql","sqlite","turso"],"created_at":"2025-03-13T04:28:31.995Z","updated_at":"2026-04-21T23:04:22.990Z","avatar_url":"https://github.com/nbbaier.png","language":"TypeScript","funding_links":[],"categories":["Cloud Services","Databases"],"sub_categories":["How to Submit"],"readme":"# mcp-turso\n\nA Model Context Protocol (MCP) server that provides access to the Turso-hosted LibSQL databases. Currently, the server provides the following functionality:\n\n-  Retrieving a list of tables in a database\n-  Retrieving a database's schema\n-  Retrieving the schema of a table\n-  Performing SELECT queries\n\n## Configuration\n\n### With Claude Desktop\n\nAdd this to your `claude_desktop_config.json`:\n\n```json\n{\n   \"mcpServers\": [\n      \"turso\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"mcp-turso\"],\n         \"env\": {\n            \"TURSO_DATABASE_URL\": \"your_url\",\n            \"TURSO_AUTH_TOKEN\": \"your_token\"\n         }\n      }\n   ]\n}\n```\n\nYou will need an existing database to continue. If you don't have one, [create one](https://docs.turso.tech/quickstart). To get the database URL via the Turso CLI, run:\n\n```bash\nturso db show --url \u003cdatabase-name\u003e\n```\n\nThen get the database authentication token:\n\n```bash\nturso db tokens create \u003cdatabase-name\u003e\n```\n\nAdd those values to your configuration as shown above.\n\n### With Cursor\n\nTo configure the Turso MCP server with Cursor, add the following to your Cursor settings:\n\n1. Open Cursor and go to Settings (⚙️) \u003e Settings (JSON)\n2. Add the following configuration to your settings JSON:\n\n```json\n\"mcpServers\": {\n  \"turso\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"mcp-turso\"],\n    \"env\": {\n      \"TURSO_DATABASE_URL\": \"your_url\",\n      \"TURSO_AUTH_TOKEN\": \"your_token\"\n    }\n  }\n}\n```\n\nReplace `your_url` and `your_token` with your Turso database URL and authentication token as described in the previous section.\n\n### Logging\n\nThe server includes a custom logger for debugging outside of Claude Desktop. By default, this logger writes to `\u003cparent-dir\u003e/logs/mcp-turso.log`, where `\u003cparent-dir\u003e` is the parent directory of directory containing the `mcp-turso` script. In other words, if the path to `mcp-turso` is `~/foo/bin/mcp-turso`, the logs will be at `~/foo/logs/mcp-turso.log`. If running with NPX as above, the default logs will be:\n\n```\n~/.npm/_npx/\u003cnpx-dir-name\u003e/node_modules/mcp-turso/logs/mcp-turso.log\n```\n\nIf you would like to specify a custom path, you can include a `--logs` flag with an **absolute posix path** in the server's configuration:\n\n```json\n{\n   \"mcpServers\": [\n      \"turso\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"mcp-turso\", \"--logs\", \"/Users/\u003cusername\u003e/path/to/dir/mcp-logs.log\"],\n         \"env\": {\n            \"TURSO_DATABASE_URL\": \"your_url\",\n            \"TURSO_AUTH_TOKEN\": \"your_token\"\n         }\n      }\n   ]\n}\n```\n\nThe path to the log file (default or custom) is always logged to `stderr` when the server is created. For Claude desktop, this will show up in your server logs in `~/Library/Logs/Claude`.\n\n_Note_: Right now, I haven't implemented specifying a custom logging file for Windows, but this is coming.\n\n## Server Capabilities\n\nThe server provides the following tools:\n\n-  `list_tables`\n   -  Get a list of all the tables in the database\n   -  No input\n   -  Returns: an array of table names\n-  `get_db_schema`\n   -  Get the schemas of all tables in the database\n   -  No input\n   -  Returns: an array of SQL creation statements\n-  `describe_table`\n   -  View schema information for a specific table\n   -  Input:\n      -  `table_name` (string): Name of table to describe\n   -  Returns: Array of column definitions with names and types\n-  `query_database`\n   -  Execute a SELECT query to read data from the database\n   -  Input:\n      -  `sql` (string): The SELECT SQL query to execute\n   -  Returns: Query results as an object of type `{ columns: string[]; rows: Record\u003cstring, unknown\u003e[]; rowCount: number; }`\n\n## Todo\n\n-  [ ] Add the ability to specify a custom log file on windows\n-  [ ] Add more query tools\n\n## License\n\nMIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnbbaier%2Fmcp-turso","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnbbaier%2Fmcp-turso","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnbbaier%2Fmcp-turso/lists"}