MCP Turso

🚀 MCP-Turso 服务端

MCP-Turso 服务端是一个基于 Model Context Protocol (MCP) 的服务器，它提供了对 Turso 主持的 LibSQL 数据库的访问能力。目前，该服务器具备以下实用功能：

• 获取数据库中的表列表。
• 获取数据库的整体架构。
• 获取指定表的架构信息。
• 执行 SELECT 查询。

🚀 快速开始

✨ 主要特性

• 功能丰富：提供了获取表列表、数据库架构、特定表架构以及执行 SELECT 查询等功能。
• 多平台配置支持：支持在 Claude Desktop 和 Cursor 中进行配置。
• 自定义日志记录：包含自定义日志记录器，方便调试。

📦 安装指南

使用 Claude Desktop

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

{
   "mcpServers": [
      {
         "turso": {
            "command": "npx",
            "args": ["-y", "mcp-turso"],
            "env": {
               "TURSO_DATABASE_URL": "你的数据库 URL",
               "TURSO_AUTH_TOKEN": "你的认证令牌"
            }
         }
      }
   ]
}

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

turso db show --url <database-name>

然后获取数据库的认证令牌：

turso db tokens create <database-name>

将这些值添加到上述配置中。

使用 Cursor

要在 Cursor 中配置 Turso MCP 服务器，按照以下步骤操作：

1. 打开 Cursor，前往设置 (⚙️) > 设置 (JSON)。
2. 将以下配置添加到你的设置 JSON 文件中：

"mcpServers": {
  "turso": {
    "command": "npx",
    "args": ["-y", "mcp-turso"],
    "env": {
      "TURSO_DATABASE_URL": "你的数据库 URL",
      "TURSO_AUTH_TOKEN": "你的认证令牌"
    }
  }
}

用你的 Turso 数据库 URL 和认证令牌替换 your_url 和 your_token，如上文所述。

🔧 技术细节

日志记录

该服务器包含一个自定义日志记录器，用于在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 路径来设置自定义日志路径，但目前 Windows 系统不完全支持。

💻 使用示例

功能列表

• list_tables：获取数据库中的表列表。
• get_db_schema：获取整个数据库的架构信息。
• describe_table：获取某个特定表的架构信息。
• query_database：执行任意 SELECT 查询并返回结果。

输入输出说明

list_tables

输入：无
输出：包含所有表名称的列表。

get_db_schema

输入：无
输出：整个数据库的架构信息，包括表、列和其他结构。

describe_table

输入：表名称
输出：指定表的详细架构信息，包括列名、数据类型等。

query_database

输入：SQL 查询语句
输出：查询结果集，通常以表格形式返回。

📄 待办事项

• 支持 Windows 系统的日志记录功能。
• 增加对更多数据库操作的支持。