mcp-turso

mcp-turso

一个可访问 Turso 托管的 LibSQL 数据库的 Model Context Protocol（MCP）服务。目前，该服务提供以下功能：

• 获取数据库中的表列表
• 获取数据库的架构
• 获取表的架构
• 执行 SELECT 查询

配置

使用 Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
   "mcpServers": [
      "turso": {
         "command": "npx",
         "args": ["-y", "mcp-turso"],
         "env": {
            "TURSO_DATABASE_URL": "your_url",
            "TURSO_AUTH_TOKEN": "your_token"
         }
      }
   ]
}

你需要一个现有数据库才能继续。如果你还没有数据库，请创建一个。要通过 Turso CLI 获取数据库 URL，请运行：

turso db show --url <database-name>

然后获取数据库身份验证令牌：

turso db tokens create <database-name>

如上所示，将这些值添加到配置中。

使用 Cursor

要在 Cursor 中配置 Turso MCP 服务，请将以下内容添加到 Cursor 设置中：

1. 打开 Cursor，然后前往 Settings（⚙️）> Settings (JSON)
2. 将以下配置添加到设置 JSON 中：

"mcpServers": {
  "turso": {
    "command": "npx",
    "args": ["-y", "mcp-turso"],
    "env": {
      "TURSO_DATABASE_URL": "your_url",
      "TURSO_AUTH_TOKEN": "your_token"
    }
  }
}

按照上一节中的说明，将 your_url 和 your_token 替换为你的 Turso 数据库 URL 和身份验证令牌。

日志记录

该服务包含一个自定义日志记录器，用于在 Claude Desktop 之外进行调试。默认情况下，此日志记录器会将日志写入 <parent-dir>/logs/mcp-turso.log，其中 <parent-dir> 是包含 mcp-turso 脚本的目录的父目录。换句话说，如果 mcp-turso 的路径是 ~/foo/bin/mcp-turso，日志将位于 ~/foo/logs/mcp-turso.log。如果像上面那样使用 NPX 运行，默认日志路径为：

~/.npm/_npx/<npx-dir-name>/node_modules/mcp-turso/logs/mcp-turso.log

如果要指定自定义路径，可以在服务的配置中添加 --logs 标志，并使用绝对 posix 路径：

{
   "mcpServers": [
      "turso": {
         "command": "npx",
         "args": ["-y", "mcp-turso", "--logs", "/Users/<username>/path/to/dir/mcp-logs.log"],
         "env": {
            "TURSO_DATABASE_URL": "your_url",
            "TURSO_AUTH_TOKEN": "your_token"
         }
      }
   ]
}

创建服务时，日志文件路径（默认或自定义）始终会记录到 stderr。对于 Claude Desktop，该路径会显示在 ~/Library/Logs/Claude 中的服务日志里。

注意：目前，我还没有实现为 Windows 指定自定义日志文件的功能，但此功能即将推出。

服务功能

该服务提供以下工具：

• list_tables
  • 获取数据库中的所有表的列表
  • 无输入
  • 返回：表名数组
• get_db_schema
  • 获取数据库中所有表的架构
  • 无输入
  • 返回：SQL 创建语句数组
• describe_table
  • 查看特定表的架构信息
  • 输入：
    • table_name（字符串）：要查看的表名
  • 返回：包含列名称和类型的列定义数组
• query_database
  • 执行 SELECT 查询，从数据库读取数据
  • 输入：
    • sql（字符串）：要执行的 SELECT SQL 查询
  • 返回：查询结果，类型为 { columns: string[]; rows: Record<string, unknown>[]; rowCount: number; } 的对象

待办事项

• 添加在 windows 上指定自定义日志文件的功能
• 添加更多查询工具

许可证

MIT 许可证——详情请参阅 LICENSE 文件。