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": "你的数据库 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 系统的日志记录功能。
• 增加对更多数据库操作的支持。