mcp-turso-云

模型上下文协议 (MCP) 服务器，为 LLM 提供与 Turso 数据库的集成。该服务器实现了两级身份验证系统，可同时处理组织级和数据库级操作，从而可以轻松地直接从 LLM 管理和查询 Turso 数据库。

特征

🏢 组织级运营

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

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

• 删除数据库：从您的组织中删除数据库

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

💾 数据库级操作

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

• 执行只读查询：运行 SELECT 和 PRAGMA 查询（只读操作）

• 执行查询：运行可能具有破坏性的 SQL 查询（INSERT、UPDATE、DELETE 等）

• 描述表：获取数据库表的架构信息

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

⚠️ 重要：查询执行安全性 ⚠️

该服务器实现了只读和破坏性数据库操作之间的以安全性为中心的分离：

• 使用execute_read_only_query进行SELECT和PRAGMA查询（安全的只读操作）

• 使用execute_query进行INSERT、UPDATE、DELETE、CREATE、DROP和其他修改数据的操作

这种分离允许不同的权限级别和批准要求：

• 在许多情况下，只读操作可以自动批准

• 破坏性操作可能需要明确的安全批准

**在批准 SQL 查询之前，务必仔细阅读并审核！**这对于可能修改或删除数据的破坏性操作尤其重要。在允许执行每个查询之前，请花时间了解其作用。

两级认证系统

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

1. 组织级身份验证

   • 使用 Turso 平台 API 令牌

   • 管理数据库和组织级操作

   • 通过 Turso 仪表板获取

2. 数据库级身份验证

   • 使用数据库特定的令牌

   • 使用组织令牌自动生成

   • 缓存以提高性能并根据需要轮换

配置

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

Cline/Claude 桌面配置

将其添加到您的 Cline/Claude Desktop MCP 设置中：

带有 WSL 配置的 Claude 桌面

对于 WSL 环境，将其添加到您的 Claude Desktop 配置中：

环境变量

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

• TURSO_API_TOKEN ：您的 Turso 平台 API 令牌（必需）

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

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

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

• TOKEN_PERMISSION ：生成令牌的权限级别（可选，默认值：“完全访问”）

API

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

组织工具

列出数据库

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

参数：无

响应示例：

创建数据库

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

参数：

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

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

• regions （string[]，可选）：部署数据库的区域

例子：

删除数据库

从您的组织中删除数据库。

参数：

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

例子：

生成数据库令牌

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

参数：

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

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

• permission （字符串，可选）：权限级别（“完全访问”或“只读”）

例子：

数据库工具

列表表

列出数据库中的所有表。

参数：

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

例子：

执行只读查询

对数据库执行只读 SQL 查询（SELECT、PRAGMA）。

参数：

• query （字符串，必需）：要执行的 SQL 查询（必须是 SELECT 或 PRAGMA）

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

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

例子：

执行查询

对数据库执行具有潜在破坏性的 SQL 查询（INSERT、UPDATE、DELETE、CREATE 等）。

参数：

• query （字符串，必需）：要执行的 SQL 查询（不能是 SELECT 或 PRAGMA）

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

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

例子：

描述表

获取表的架构信息。

参数：

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

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

例子：

向量搜索

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

参数：

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

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

• query_vector (number[]，必需)：用于相似性搜索的查询向量

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

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

例子：

发展

设置

1. 克隆存储库

2. 安装依赖项：

3. 构建项目：

4. 以开发模式运行：

出版

1. 更新 package.json 中的版本

2. 构建项目：

3. 发布到 npm：

故障排除

API 令牌问题

如果遇到身份验证错误：

1. 验证您的 Turso API 令牌是否有效并具有必要的权限

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

3. 确保您的令牌尚未过期

数据库连接问题

如果您在连接数据库时遇到问题：

1. 验证数据库是否存在于您的组织中

2. 检查你的 API 令牌是否可以访问数据库

3. 确保数据库名称拼写正确

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

MIT 许可证 - 有关详细信息，请参阅LICENSE文件。

致谢

构建于：

• 模型上下文协议

• Turso数据库

• 库SQL