数据库查询服务

Turso MCP 服务器

一个模型上下文协议（MCP）服务器用于 Turso（人名或地名，具体含义需根据上下文确定，此处直接音译） (libSQL) 数据库访问。

特点/功能

• 执行SQL查询（SELECT、INSERT、UPDATE、DELETE）
• 列出数据库中的所有表
• 描述表结构
• 分页检索表数据
• 完全支持参数化查询

安装

npm install -g @gamzadongza/turso-mcp-server

配置

环境变量

您需要设置这些环境变量：

• TURSO_DATABASE_URL您的 Turso 数据库 URL（例如， libsql://your-db.turso.io）
• TURSO_AUTH_TOKEN您的Turso身份验证令牌

获取 Turso 凭据

1. 安装 Turso CLI：

# Windows (PowerShell)
irm https://get.tur.so/install.ps1 | iex

# macOS/Linux
curl -sSfL https://get.tur.so/install.sh | bash

2. 登录并创建数据库：

turso auth login
turso db create my-database

3. 获取您的凭证：

# Get database URL
turso db show my-database --url

# Create auth token
turso db tokens create my-database

与Claude桌面版的使用

将此添加到您的Claude桌面配置中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "turso": {
      "command": "turso-mcp-server",
      "env": {
        "TURSO_DATABASE_URL": "libsql://your-db.turso.io",
        "TURSO_AUTH_TOKEN": "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9..."
      }
    }
  }
}

与Claude Mobile（Android/iOS）一起使用

1. 进入Claude应用设置
2. 从Smithery添加MCP服务器： @gamzadongza/turso-mcp-server
3. 设置环境变量：
   • TURSO_DATABASE_URL您的数据库URL
   • TURSO_AUTH_TOKEN您的认证令牌

可用工具

execute_query

在您的 Turso 数据库上执行任何 SQL 查询。

参数：

• query （字符串，必填）：要执行的SQL查询
• params (数组，可选)：用于参数化查询的参数

示例：

SELECT * FROM users WHERE age > ?

list_tables

获取数据库中所有表的列表。

示例： “显示我数据库中的所有表”

describe_table

获取特定表的详细架构信息。

参数：

• table_name (字符串，必填): 表名

示例： “描述用户表的结构”

get_table_data

从支持分页的表中检索数据。

参数：

• table_name （字符串，必填）：表名
• limit (数字，可选)：要返回的最大行数（默认：100，最大：1000）
• offset (数字，可选)：要跳过的行数（默认：0）

示例： “从帖子表中获取前50行数据”

发展

# Clone and install dependencies
git clone https://github.com/gamzadongza/turso-mcp-server
cd turso-mcp-server
npm install

# Build
npm run build

# Run locally
export TURSO_DATABASE_URL="libsql://your-db.turso.io"
export TURSO_AUTH_TOKEN="your-token"
node dist/index.js

许可证

麻省理工学院（MIT）

链接

• Turso（根据上下文，可能指特定人名、地名或品牌名等，此处直接音译）
• 模型上下文协议
• MCP服务器