首页/数据库/mcp-turso

mcp-turso

查看源码
2025-5-12
Words 776Read Time 2 min
Score:85

用于与Turso托管的LibSQL数据库交互的MCP服务器,支持查询表结构、执行SELECT操作等功能。

TypeScript

mcp-turso

一个基于 Model Context Protocol (MCP) 的服务器,提供对 Turso 托管的 LibSQL 数据库的访问。目前,该服务器提供以下功能:
  • 获取数据库中的表列表
  • 获取数据库的 schema
  • 获取表的 schema
  • 执行 SELECT 查询

配置

与 Claude Desktop 集成

将以下内容添加到 claude_desktop_config.json 文件中:
您需要有一个现有的数据库才能继续。如果没有,请创建一个。要通过 Turso CLI 获取数据库 URL,请运行以下命令:
然后获取数据库的身份验证令牌:
将上述值添加到您的配置中,如上所示。

与 Cursor 集成

要在 Cursor 中配置 Turso MCP 服务器,请将以下内容添加到 Cursor 设置中:
  1. 打开 Cursor 并进入 Settings (⚙️) > Settings (JSON)
  1. 在设置 JSON 中添加以下配置:
your_urlyour_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 运行,默认日志将位于:
如果您想指定自定义路径,可以在服务器配置中包含 --logs 标志,并提供一个 绝对 POSIX 路径
日志文件的路径(默认或自定义)在服务器创建时始终会记录到 stderr。对于 Claude Desktop,这将显示在 ~/Library/Logs/Claude 的服务器日志中。
注意:目前尚未实现为 Windows 指定自定义日志文件的功能,但即将推出。

服务器功能

服务器提供以下工具:
  • list_tables
    • 获取数据库中的所有表列表
    • 无输入
    • 返回:表名数组
  • get_db_schema
    • 获取数据库中所有表的 schema
    • 无输入
    • 返回:SQL 创建语句数组
  • describe_table
    • 查看特定表的 schema 信息
    • 输入:
      • table_name (string):要描述的表名
    • 返回:包含列名和类型的列定义数组
  • query_database
    • 执行 SELECT 查询以从数据库中读取数据
    • 输入:
      • sql (string):要执行的 SELECT SQL 查询
    • 返回:查询结果,类型为 { columns: string[]; rows: Record<string, unknown>[]; rowCount: number; }

待办事项

添加在 Windows 上指定自定义日志文件的功能
添加更多查询工具

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。
上一篇
mcp-trino
下一篇
logseq-mcp-tools