Mcp Turso

Mcp Turso

🚀 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 

然后获取数据库的认证令牌:

turso db tokens create 

将这些值添加到上述配置中。

使用 Cursor

要在 Cursor 中配置 Turso MCP 服务器,按照以下步骤操作:

  1. 打开 Cursor,前往设置 (⚙️) > 设置 (JSON)。
  2. 将以下配置添加到你的设置 JSON 文件中:
{
"mcpServers": {
"turso": {
"command": "npx",
"args": ["-y", "mcp-turso"],
"env": {
"TURSO_DATABASE_URL": "你的数据库 URL",
"TURSO_AUTH_TOKEN": "你的认证令牌"
}
}
}
}

用你的 Turso 数据库 URL 和认证令牌替换 your_urlyour_token,如上文所述。

🔧 日志记录

该服务器包含一个自定义日志记录器,用于在Claude Desktop之外进行调试。默认情况下,此日志记录器写入 /logs/mcp-turso.log,其中 是包含 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 查询语句 查询结果集,通常以表格形式返回

📚 详细文档

待办事项

  • 支持 Windows 系统的日志记录功能。
  • 增加对更多数据库操作的支持。
  • 0 关注
  • 0 收藏,10 浏览
  • system 提出于 2025-09-24 14:24

相似服务问题