MCP-Turso 服务端是一个基于 Model Context Protocol (MCP) 的服务器,它提供了对 Turso 主持的 LibSQL 数据库的访问能力。目前,该服务器具备以下实用功能:
MCP-Turso 服务端提供了一系列便捷功能,能够帮助开发者高效地与 Turso 主持的 LibSQL 数据库进行交互,具体功能如下:
list_tables
:获取数据库中的表列表。get_db_schema
:获取整个数据库的架构信息。describe_table
:获取某个特定表的架构信息。query_database
:执行任意 SELECT 查询并返回结果。将以下内容添加到你的 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
然后获取数据库的认证令牌:
turso db tokens create
将这些值添加到上述配置中。
要在 Cursor 中配置 Turso MCP 服务器,按照以下步骤操作:
{
"mcpServers": {
"turso": {
"command": "npx",
"args": ["-y", "mcp-turso"],
"env": {
"TURSO_DATABASE_URL": "你的数据库 URL",
"TURSO_AUTH_TOKEN": "你的认证令牌"
}
}
}
}
用你的 Turso 数据库 URL 和认证令牌替换 your_url
和 your_token
,如上文所述。
该服务器包含一个自定义日志记录器,用于在Claude Desktop之外进行调试。默认情况下,此日志记录器写入
,其中
是包含 mcp-turso
脚本的目录的父目录。例如,如果 mcp-turso
的路径是 ~/foo/bin/mcp-turso
,则日志文件位于 ~/foo/logs/mcp-turso.log
。如果使用上述 NPX 配置运行,则默认日志位置为:
~/.npm/_npx//node_modules/mcp-turso/logs/mcp-turso.log
你可以通过指定绝对 posix 路径来设置自定义日志路径,但目前 Windows 系统不完全支持。
功能 | 输入 | 输出 |
---|---|---|
list_tables |
无 | 包含所有表名称的列表 |
get_db_schema |
无 | 整个数据库的架构信息,包括表、列和其他结构 |
describe_table |
表名称 | 指定表的详细架构信息,包括列名、数据类型等 |
query_database |
SQL 查询语句 | 查询结果集,通常以表格形式返回 |