mcp-turso-cloud

一个 Model Context Protocol (MCP) 服务器，为大型语言模型（LLMs）提供与 Turso 数据库的集成。该服务器实现了两级身份验证系统，用于处理组织级和数据库级操作，使得直接从 LLMs 管理和查询 Turso 数据库变得更加便捷。

功能特性

🏢 组织级操作

列出数据库：查看 Turso 组织中的所有数据库

创建数据库：使用可自定义选项创建新数据库

删除数据库：从组织中移除数据库

生成数据库令牌：为特定数据库创建身份验证令牌

💾 数据库级操作

列出表：查看特定数据库中的所有表

执行查询：对数据库运行 SQL 查询

描述表：获取数据库表的模式信息

向量搜索：使用 SQLite 向量扩展执行向量相似性搜索

两级身份验证系统

服务器实现了复杂的两级身份验证系统：

组织级身份验证

使用 Turso Platform API 令牌

管理数据库和组织级操作

通过 Turso 仪表板获取

数据库级身份验证

使用数据库特定的令牌

使用组织令牌自动生成

为提高性能进行缓存，并在需要时轮换

配置

该服务器需要通过 MCP 客户端进行配置。以下是不同环境下的配置示例：

Cline/Claude Desktop 配置

将以下内容添加到 Cline/Claude Desktop 的 MCP 设置中：

Claude Desktop with WSL 配置

对于 WSL 环境，将以下内容添加到 Claude Desktop 配置中：

环境变量

服务器需要以下环境变量：

TURSO_API_TOKEN：您的 Turso Platform API 令牌（必需）

TURSO_ORGANIZATION：您的 Turso 组织名称（必需）

TURSO_DEFAULT_DATABASE：未指定数据库时使用的默认数据库（可选）

TOKEN_EXPIRATION：生成的数据库令牌的过期时间（可选，默认：'7d'）

TOKEN_PERMISSION：生成的令牌的权限级别（可选，默认：'full-access'）

API

服务器实现了按类别组织的 MCP 工具：

组织工具

list_databases

列出 Turso 组织中的所有数据库。

参数：无

示例响应：

create_database

在组织中创建一个新数据库。

参数：

name（字符串，必需）：新数据库的名称

group（字符串，可选）：分配给数据库的组

regions（字符串数组，可选）：部署数据库的区域

示例：

delete_database

从组织中删除一个数据库。

参数：

name（字符串，必需）：要删除的数据库名称

示例：

generate_database_token

为特定数据库生成新令牌。

参数：

database（字符串，必需）：数据库名称

expiration（字符串，可选）：令牌过期时间

permission（字符串，可选）：权限级别（'full-access' 或 'read-only'）

示例：

数据库工具

list_tables

列出数据库中的所有表。

参数：

database（字符串，可选）：数据库名称（如果未提供，则使用上下文）

示例：

execute_query

对数据库执行 SQL 查询。

参数：

query（字符串，必需）：要执行的 SQL 查询

params（对象，可选）：查询参数

database（字符串，可选）：数据库名称（如果未提供，则使用上下文）

示例：

describe_table

获取表的模式信息。

参数：

table（字符串，必需）：表名

database（字符串，可选）：数据库名称（如果未提供，则使用上下文）

示例：

vector_search

使用 SQLite 向量扩展执行向量相似性搜索。

参数：

table（字符串，必需）：表名

vector_column（字符串，必需）：包含向量的列

query_vector（数字数组，必需）：用于相似性搜索的查询向量

limit（数字，可选）：最大结果数（默认：10）

database（字符串，可选）：数据库名称（如果未提供，则使用上下文）

示例：

开发

设置

克隆仓库

安装依赖：

构建项目：

在开发模式下运行：

发布

更新 package.json 中的版本号

构建项目：

发布到 npm：

故障排除

API 令牌问题

如果遇到身份验证错误：

确认您的 Turso API 令牌有效且具有必要的权限

检查您的组织名称是否正确

确保您的令牌未过期

数据库连接问题

如果无法连接到数据库：

确认数据库存在于您的组织中

检查您的 API 令牌是否有访问该数据库的权限

确保数据库名称拼写正确

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

致谢

基于以下项目构建：

Model Context Protocol

Turso Database

libSQL