JinDaGe - mcp-turso MCP Details

article

README

🚀 MCP-Turso 服务端

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

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

🚀 快速开始

✨ 主要特性

MCP-Turso 服务端提供了一系列便捷功能，能够帮助开发者高效地与 Turso 主持的 LibSQL 数据库进行交互，具体功能如下：

list_tables：获取数据库中的表列表。
get_db_schema：获取整个数据库的架构信息。
describe_table：获取某个特定表的架构信息。
query_database：执行任意 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 服务器，按照以下步骤操作：

打开 Cursor，前往设置 (⚙️) > 设置 (JSON)。
将以下配置添加到你的设置 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 | SQL 查询语句 | 查询结果集，通常以表格形式返回 |

📚 详细文档

待办事项

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

mcp-turso