mcp-turso

简介

MCP-Turso 是一个模型上下文协议服务器，为大型语言模型提供 Turso 数据库集成功能。它实现了两级认证系统，使 AI 可以直接管理和查询 Turso 数据库。

核心功能

• 组织级操作：列出、创建、删除数据库，生成数据库令牌
• 数据库级操作：列出表、执行查询、描述表结构、执行向量搜索

安装设置

环境变量配置

TURSO_API_TOKEN=你的Turso平台API令牌      # 必需
TURSO_ORGANIZATION=你的Turso组织名称      # 必需
TURSO_DEFAULT_DATABASE=默认数据库名称     # 可选
TOKEN_EXPIRATION=7d                     # 可选，默认7天
TOKEN_PERMISSION=full-access            # 可选，默认完全访问

Cline MCP 配置

{
  "mcpServers": {
    "mcp-turso": {
      "command": "node",
      "args": ["/path/to/mcp-turso/dist/index.js"],
      "env": {
        "TURSO_API_TOKEN": "your-turso-api-token",
        "TURSO_ORGANIZATION": "your-organization-name",
        "TURSO_DEFAULT_DATABASE": "optional-default-database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude 桌面版 WSL 配置

{
  "mcpServers": {
    "mcp-turso": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "TURSO_API_TOKEN=your-token TURSO_ORGANIZATION=your-org node /path/to/mcp-turso/dist/index.js"
      ]
    }
  }
}

常用操作示例

列出所有数据库

// 无需参数
{}

创建新数据库

{
  "name": "analytics_db",
  "group": "production",
  "regions": ["us-east", "eu-west"]
}

执行 SQL 查询

{
  "query": "SELECT * FROM users WHERE age > ?",
  "params": { "1": 21 },
  "database": "customer_db"
}

向量搜索

{
  "table": "embeddings",
  "vector_column": "embedding",
  "query_vector": [0.1, 0.2, 0.3, 0.4],
  "limit": 5,
  "database": "vector_db"
}

故障排除

• 认证问题：确认 API 令牌有效并有适当权限
• 连接问题：检查数据库名称拼写正确，确认数据库存在
• 权限错误：验证令牌访问级别是否匹配操作需求

更多信息

详细 API 文档、贡献指南及更多信息请查看完整文档。

许可证

MIT 许可证