mcp-turso

一个模型上下文协议 (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

如果您想指定自定义路径，您可以在服务器的配置中包含一个带有绝对 posix 路径的 --logs 标志：

{
   "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 (string): 要描述的表的名称

  • 返回：带有名称和类型的列定义数组

• query

  • 执行 SELECT 查询以从数据库读取数据
  • 输入：
    • query (string): 要执行的 SELECT SQL 查询
  • 返回：查询结果，类型为 { columns: string[]; rows: Record<string, unknown>[]; rowCount: number; } 的对象

待办事项

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

许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。