使用说明

项目简介

该项目是一个基于 Model Context Protocol (MCP) 的服务器，旨在将 Turso 数据库的功能集成到 LLM 应用中。通过此服务器，LLM 可以安全地管理 Turso 数据库、执行 SQL 查询、检索表结构，甚至进行向量相似性搜索。它采用双层认证系统，确保组织和数据库级别的安全访问控制。

主要功能点

组织级数据库管理：
- 列出 Turso 组织中的所有数据库。
- 创建新的 Turso 数据库。
- 删除 Turso 数据库。
- 为数据库生成访问令牌。
数据库操作：
- 列出数据库中的所有表。
- 执行 SQL 查询，包括读写操作。
- 获取表的结构信息（Schema）。
- 进行向量相似度搜索（如果数据库已启用向量扩展）。

安装步骤

克隆仓库

git clone https://github.com/spences10/mcp-turso-cloud.git

进入项目目录
```
cd mcp-turso-cloud
```
安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置

为了让 MCP 客户端能够连接到此服务器，您需要在客户端中配置 MCP 服务器信息。以下是一个 Cline 客户端的配置示例，您需要根据您的实际环境进行调整。

{
  "mcpServers": {
    "turso-cloud": {  //  服务器名称，可以自定义，用于在客户端中标识该服务器
      "command": "node",  // 运行服务器的命令，这里使用 Node.js
      "args": ["/path/to/mcp-turso-cloud/dist/index.js"], //  服务器入口文件路径，请替换为实际路径
      "env": {
        "TURSO_API_TOKEN": "YOUR_TURSO_API_TOKEN",  //  您的 Turso 平台 API 令牌，**必填**
        "TURSO_ORGANIZATION": "YOUR_TURSO_ORGANIZATION_NAME"  //  您的 Turso 组织名称，**必填**
        // "TURSO_DEFAULT_DATABASE": "optional-default-database" //  可选的默认数据库名称
        // "TOKEN_EXPIRATION": "7d" //  可选的令牌过期时间，默认为 7 天
        // "TOKEN_PERMISSION": "full-access"  //  可选的令牌权限级别，默认为 full-access
      },
      "disabled": false, //  设置为 false 以启用该服务器
      "autoApprove": [] //  可以自动批准执行的工具列表
    }
  }
}

注意:

请将 '/path/to/mcp-turso-cloud/dist/index.js' 替换为 'mcp-turso-cloud' 仓库在您系统中的实际路径。
将 'YOUR_TURSO_API_TOKEN' 和 'YOUR_TURSO_ORGANIZATION_NAME' 替换为您的 Turso 平台 API 令牌和组织名称。您可以在 Turso 控制面板中获取 API 令牌。

基本使用方法

启动 MCP 服务器：在配置完成后，当 MCP 客户端尝试连接到该服务器时，服务器将自动启动。
在 LLM 应用中使用工具：您可以在 LLM 应用中调用该 MCP 服务器提供的工具，例如 'list_databases'（列出数据库）、'execute_query'（执行 SQL 查询）等，具体工具及其参数请参考该仓库的 'README.md' 文档中 "API" 章节的描述。

关键词