mcp-turso
一个基于 Model Context Protocol (MCP) 的服务器,提供对 Turso 托管的 LibSQL 数据库的访问。目前,该服务器提供以下功能:
- 获取数据库中的表列表
- 获取数据库的 schema
- 获取表的 schema
- 执行 SELECT 查询
配置
与 Claude Desktop 集成
将以下内容添加到
claude_desktop_config.json
文件中:然后获取数据库的身份验证令牌:
将上述值添加到您的配置中,如上所示。
与 Cursor 集成
要在 Cursor 中配置 Turso MCP 服务器,请将以下内容添加到 Cursor 设置中:
- 打开 Cursor 并进入 Settings (⚙️) > Settings (JSON)
- 在设置 JSON 中添加以下配置:
将
your_url
和 your_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 文件。
- Author:waytomcp
- URL:https://www.waytomcp.com/article/nbbaier/mcp-turso
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!