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 凭据
- 安装 Turso CLI:
# Windows (PowerShell)
irm https://get.tur.so/install.ps1 | iex
# macOS/Linux
curl -sSfL https://get.tur.so/install.sh | bash- 登录并创建数据库:
turso auth login
turso db create my-database- 获取您的凭证:
# 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)一起使用
- 进入Claude应用设置
- 从Smithery添加MCP服务器:
@gamzadongza/turso-mcp-server - 设置环境变量:
- 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)
