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": "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服务器，请执行以下步骤：

1. 打开Cursor并进入设置（⚙️）> 设置（JSON）
2. 在你的设置JSON中添加以下配置：

"mcpServers": {
  "turso": {
    "command": "npx",
    "args": ["-y", "mcp-turso"],
    "env": {
      "TURSO_DATABASE_URL": "your_url",
      "TURSO_AUTH_TOKEN": "your_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路径的--logs标志：

{
   "mcpServers": [
      "turso": {
         "command": "npx",
         "args": ["-y", "m-urso", "--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文件。