mcp-turso

一个提供对Turso托管的LibSQL数据库访问的模型上下文协议（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并转到设置（⚙️）> 设置（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

如果您想指定自定义路径，可以在服务器配置中包含一个带有绝对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桌面，这将显示在~/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文件。