mcp-turso

mcp-turso

site icon
2025.04.13 4
TypeScript数据库访问Turso 集成数据库
mcp-turso 是一个基于 Model Context Protocol (MCP) 的服务,提供对 Turso 托管的 LibSQL 数据库的访问。它支持获取数据库中的表列表、数据库模式、表模式以及执行 SELECT 查询。适用于需要与 Turso 数据库交互的开发场景。
View on GitHub

Overview

基本能力

产品定位

mcp-turso 是一个数据库访问服务,专门用于与 Turso 托管的 LibSQL 数据库进行交互。

核心功能

  • 获取数据库中的表列表
  • 获取数据库的模式
  • 获取特定表的模式
  • 执行 SELECT 查询

适用场景

  • 开发过程中需要快速查看数据库结构和内容
  • 需要从 Turso 数据库中读取数据的应用

工具列表

  • list_tables: 获取数据库中的所有表名
  • get_db_schema: 获取数据库中所有表的 SQL 创建语句
  • describe_table: 查看特定表的列定义和类型
  • query: 执行 SELECT 查询并返回结果

常见问题解答

  • 日志文件默认存储在 ~/.npm/_npx/<npx-dir-name>/node_modules/mcp-turso/logs/mcp-turso.log
  • 可以通过 --logs 参数指定自定义日志路径(目前仅支持 POSIX 路径)

使用教程

使用依赖

  • 需要已存在的 Turso 数据库
  • 需要 Turso CLI 工具

安装教程

  1. claude_desktop_config.json 中添加以下配置:
{
   "mcpServers": [
      "turso": {
         "command": "npx",
         "args": ["-y", "mcp-turso"],
         "env": {
            "TURSO_DATABASE_URL": "your_url",
            "TURSO_AUTH_TOKEN": "your_token"
         }
      }
   ]
}
  1. 获取数据库 URL:
turso db show --url <database-name>
  1. 获取数据库认证令牌:
turso db tokens create <database-name>

调试方式

  • 日志文件路径会在服务器创建时输出到 stderr
  • 在 Claude Desktop 中,日志会出现在 ~/Library/Logs/Claude

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。