mcp-turso

这是一个 Model Context Protocol (MCP) 服务器，提供了访问 Turso 托管的 LibSQL 数据库的功能。目前，该服务器提供了以下功能：

• 获取数据库中的表列表
• 获取数据库模式
• 获取表的模式
• 执行 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>

按照上面所示的方式将这些值添加到配置文件中。

日志记录

该服务器包含了一个用于调试（在 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 桌面版用户，这将出现在 ~/Library/Logs/Claude 目录下的服务器日志里。

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

服务器功能

该服务器提供了以下工具：

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

待办事项

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

许可证

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