MCP Libsql

MCP数据服务

提供方 Xexr

数据服务 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor

Secure MCP server for libSQL databases with comprehensive tools, connection pooling, and transaction support. Built with TypeScript for Claude Desktop, Claude Code, Cursor, and other MCP clients.

一句话选型结论

按资料字段整理

MCP Libsql 属于数据服务类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 20 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

developer-toolssqldatabasesqlitemcpsqlite3claudeai-tools

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Libsql当前 未标注 未标注 未标注 无 2026-05-18
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Xexr上游标注的维护方 Xexr
分类数据服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-18上游最后核验时间

详细介绍

11.8 KB
来自项目仓库与上游目录的原文,未做删改

xexr的MCP libSQL

用于libSQL数据库操作的模型上下文协议(MCP)服务器,通过Claude Desktop、Claude Code、Cursor和其他MCP兼容客户端提供安全的数据库访问。

在Node上运行,用TypeScript编写

🔧 快速开始

  1. 安装:```bash
    pnpm install -g @xexr/mcp-libsql

1. **本地测试:**```bash
mcp-libsql --url file:///tmp/test.db --log-mode console
  1. 配置Claude桌面 使用您的Node.js路径和数据库URL(请参阅下面的配置示例)

🚀 状态

✅ 完整的数据库管理功能 -实施并测试了所有6个核心工具\
✅ 全面的安全验证 -67项安全测试,涵盖所有注射载体\
✅ 广泛的测试覆盖范围 -总共244次测试(177个单元+67个安全),通过率100%\
✅ 生产部署已验证 -成功与MCP客户合作\
✅ 稳健的错误处理 -连接重试、优雅降级和审核日志记录

🛠️ 特性

可用工具

  • 读取查询:执行带有全面安全验证的SELECT查询
  • 写查询:具有事务支持的INSERT/UPDATE/DELETE操作
  • 创建表格:用于创建具有安全措施的表的DDL操作
  • 改变桌子:表结构修改(ADD/RENAME/DROP操作)
  • 列表表格:使用筛选选项浏览数据库元数据
  • 描述表格:具有多种输出格式的表模式检查

安全性和可靠性

  • 多层SQL注入防护 具有全面的安全验证
  • 连接池 具有健康监测和自动重试逻辑
  • 交易支持 具有错误自动回滚功能
  • 全面的审计日志记录 安全合规性

> 🔐 安全详细信息: 看 docs/SECURITY.md 用于全面的安全功能和测试。

开发者体验

  • 漂亮的表格格式 正确对齐和NULL处理
  • 性能指标 显示所有操作
  • 清除错误消息 具有可操作的上下文
  • 参数化查询支持 用于安全数据处理
  • 开发模式 具有增强的日志记录和热重载功能

📋 先决条件

  • Node.js 20+
  • pnpm (或npm)包管理器
  • libSQL数据库 (基于文件或远程)
  • 克劳德桌面版 (用于MCP集成)

平台要求

  • macOS:原生Node.js安装
  • Linux:原生Node.js安装
  • 视窗:原生Node.js安装或WSL2与Node.js安装

🔧 安装```bash

Use your package manager of choice, e.g. npm, pnpm, bun etc

Install globally

pnpm install -g @xexr/mcp-libsql
mcp-libsql -v # check version

...or build from the repository

git clone https://github.com/Xexr/mcp-libsql.git
cd mcp-libsql
pnpm install # Install dependencies
pnpm build # Build the project
node dist/index.js -v # check version


## 🚀 **用法**

### **局部测试**

下面假设全局安装,如果使用本地构建,请将“mcp-libsql”替换为“node-dist/index.js”```bash
# Test with file database (default: file-only logging)
mcp-libsql --url file:///tmp/test.db

# Test with HTTP database
mcp-libsql --url http://127.0.0.1:8080

# Test with Turso database (environment variable, alternatively export the env var)
LIBSQL_AUTH_TOKEN="your-token" mcp-libsql --url "libsql://your-db.turso.io"

# Test with Turso database (CLI parameter)
mcp-libsql --url "libsql://your-db.turso.io" --auth-token "your-token"

# Development mode with console logging
mcp-libsql --dev --log-mode console --url file:///tmp/test.db

# Test with different logging modes
mcp-libsql --url --log-mode both file:///tmp/test.db

Claude桌面集成

根据您的操作系统在Claude Desktop中配置MCP服务器:

macOS配置

  1. 创建配置文件 在 ~/Library/Application Support/Claude/claude_desktop_config.json:

全局安装```json

{
"mcpServers": {
"mcp-libsql": {
"command": "mcp-libsql",
"args": [
"--url",
"file:///Users/username/database.db"
]
}
}
}


**本地构建安装的替代配置:**```json
{
"mcpServers": {
"mcp-libsql": {
"command": "node",
"args": [
"/Users/username/projects/mcp-libsql/dist/index.js",
"--url",
"file:///Users/username/database.db"
],
}
}
}

使用nvm-lts进行节点全局安装的替代配置```json
{
"mcpServers": {
"mcp-libsql": {
"command": "zsh",
"args": [
"-c",
"source ~/.nvm/nvm.sh && nvm use --lts > /dev/null && mcp-libsql --url file:///Users/username/database.db",
],
}
}
}


**重要**:建议使用全局安装方法,因为它会自动处理PATH。

#### **Linux配置**

1. **创建配置文件** 在 `~/.config/Claude/claude_desktop_config.json`:

**全局安装**```json
{
"mcpServers": {
"mcp-libsql": {
"command": "mcp-libsql",
"args": [
"--url",
"file:///home/username/database.db"
]
}
}
}

本地构建安装的替代配置:```json
{
"mcpServers": {
"mcp-libsql": {
"command": "node",
"args": [
"/home/username/projects/mcp-libsql/dist/index.js",
"--url",
"file:///home/username/database.db"
],
}
}
}


#### **Windows(WSL2)配置**

1. **创建配置文件** 在 `%APPDATA%\Claude\claude_desktop_config.json`:

**全局安装**```json
{
"mcpServers": {
"mcp-libsql": {
"command": "wsl.exe",
"args": [
"-e",
"bash",
"-c",
"mcp-libsql --url file:///home/username/database.db",
]
}
}
}

本地构建安装的替代配置:```json
{
"mcpServers": {
"mcp-libsql": {
"command": "wsl.exe",
"args": [
"-e",
"bash",
"-c",
"/home/username/projects/mcp-libsql/dist/index.js --url file:///home/username/database.db",
]
}
}
}


**使用nvm for node进行全局安装的替代配置**```json
{
"mcpServers": {
"mcp-libsql": {
"command": "wsl.exe",
"args": [
"-e",
"bash",
"-c",
"source ~/.nvm/nvm.sh && mcp-libsql --url file:///home/username/database.db",
]
}
}
}

重要:使用 wsl.exe -e (不只是 wsl.exe)以确保正确的命令处理,并避免在Windows上接收服务器命令时出现问题。

数据库身份验证

对于Turso(和其他经过认证的)数据库,您需要一个身份验证令牌。有两种安全的方法可以提供它:

全局安装如下图所示,根据您的设置进行相应调整

方法1:环境变量(推荐)

使用环境变量配置Claude Desktop (macOS/Linux示例):```bash
export LIBSQL_AUTH_TOKEN="your-turso-auth-token-here"
``````json
{
"mcpServers": {
"mcp-libsql": {
"command": "mcp-libsql",
"args": [
"--url",
"libsql://your-database.turso.io"
]
}
}
}


#### **方法2:CLI参数**```json
{
"mcpServers": {
"mcp-libsql": {
"command": "mcp-libsql",
"args": [
"--url",
"libsql://your-database.turso.io",
"--auth-token",
"your-turso-auth-token-here"
]
}
}
}

获取您的Turso认证令牌

  1. 安装Turso CLI:```bash
    curl -sSfL https://get.tur.so/install.sh | bash

1. **登录Turso:**```bash
turso auth login
  1. 创建身份验证令牌:```bash
    turso auth token create --name "mcp-libsql"

1. **获取您的数据库URL:**```bash
turso db show your-database-name --url

安全最佳实践

  • 环境变量更安全 CLI参数(令牌不会出现在进程列表中)
  • MCP配置文件可能包含令牌 -确保他们不致力于版本控制
  • 考虑使用外部秘密管理 适用于生产环境
  • 使用作用域令牌 具有最低限度的所需权限
  • 定期旋转令牌 增强安全性
  • 监控令牌使用情况 通过Turso仪表板

示例:完成Turso设置

  1. 创建和配置数据库:```bash

Create database

turso db create my-app-db

Get database URL

turso db show my-app-db --url

Output: libsql://my-app-db-username.turso.io

Create auth token

turso auth token create --name "mcp-libsql-token"

Output: your-long-auth-token-string


1. **配置Claude桌面:**```bash
export LIBSQL_AUTH_TOKEN="your-turso-auth-token-here"
``````json
{
"mcpServers": {
"mcp-libsql": {
"command": "mcp-libsql",
"args": [
"--url",
"libsql://my-app-db-username.turso.io"
]
}
}
}
  1. 测试连接:```bash

Test locally first

mcp-libsql --url "libsql://my-app-db-username.turso.io" --log-mode console


#### **配置说明**

- **文件路径**:使用绝对路径以避免路径解析问题
- **数据库URL**:
- 文件数据库: `file:///absolute/path/to/database.db`
- HTTP数据库: `http://hostname:port`
- Libsql/turso: `libsql://your-database.turso.io`
- **Node.js路径**:使用 `which node` 查找您的Node.js安装路径
- **工作目录**:设置 `cwd` 确保相对路径正确工作
- **认证**:对于Turso数据库,使用环境变量进行安全令牌处理
- **日志记录模式**:
- 默认 `file` 模式防止MCP协议中的JSON解析错误
- 使用 `--log-mode console` 用于开发调试
- 使用 `--log-mode both` 用于综合测井
- 使用 `--log-mode none` 禁用所有日志记录

2. **重新启动克劳德桌面** 完全更新配置后

1. **测试集成** 通过让Claude运行SQL查询:```
Can you run this SQL query: SELECT 1 as test

📋 可用工具

  • 读取查询 -执行带有安全验证的SELECT查询
  • 写查询 -插入/更新/删除,支持事务处理
  • 创建表格 -使用DDL安全性创建表
  • 改变桌子 -修改表结构(添加/重命名/删除)
  • 列表表格 -浏览数据库元数据和对象
  • 描述表格 -检查表架构和结构

> 📖 API详细文件: 看 docs/API.md文件 获取完整的输入/输出示例和参数。

🧪 测试```bash

Run all tests

pnpm test

Run tests in watch mode

pnpm test:watch

Run tests with coverage

pnpm test:coverage

Run specific test file

pnpm test security-verification

Lint code

pnpm lint

Fix linting issues

pnpm lint:fix

Type check

pnpm typecheck


**测试覆盖率**:403个测试,涵盖所有功能,包括边缘情况、错误场景、CLI参数、身份验证和全面的安全验证。

## ⚠️ **常见问题**

### **1.构建失败**```bash
# Clean and rebuild
rm -rf dist node_modules
pnpm install && pnpm build

2.Node.js版本问题(macOS)```

SyntaxError: Unexpected token '??='


**问题**:Claude Desktop可能会默认在您的系统上使用不支持所需功能集的旧Node.js版本。

**解决方案**:使用上面显示的全局安装和nvm节点选择方法。

### **3.服务器无法启动**

- 对于全局安装: `pnpm install -g @xexr/mcp-libsql`
- 对于本地安装:确保 `pnpm build` 被运行和 `dist/index.js` 存在
- 本地测试: `mcp-libsql --url file:///tmp/test.db`
- 配置更改后重新启动Claude Desktop

### **4.工具不可用**

- 验证数据库URL是否可访问
- 检查Claude Desktop日志中的连接错误
- 使用简单文件数据库进行测试: `file:///tmp/test.db`

### **5.JSON解析错误(已解决)**```
Expected ',' or ']' after array element in JSON

已解决:此问题是由stdout控制台日志记录引起的。这 --log-mode 选项现在默认为 file 防止此问题的模式。如果您看到这些错误,请确保您使用的是默认值 --log-mode file 或未指定 --log-mode 完全。请注意,该错误是无害的,如果您希望进行控制台日志记录,该工具仍将使用它。

6.数据库连接问题```bash

Test database connectivity

sqlite3 /tmp/test.db "SELECT 1"

Fix permissions

chmod 644 /path/to/database.db
```

> 🔧 完整的故障排除指南: 看 docs/TROUBLESHOOTING.md 获取所有问题的详细解决方案。

🏗️ 建筑

使用TypeScript和现代Node.js模式构建:

  • 连接池 具有健康监控和重试逻辑
  • 基于工具的架构 具有一致的验证和错误处理
  • 安全第一设计 具有多层输入验证功能
  • 综合测试 244个测试涵盖所有场景

🤝 贡献

  1. 遵循TypeScript严格模式和现有代码模式
  2. 为新功能编写测试
  3. 维护安全措施
  4. 更新文档

发展: pnpm dev • 构建: pnpm build • 测试: pnpm test

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🔗 链接

  • 模型上下文协议
  • MCP TypeScript SDK
  • libSQL文档
  • 克劳德桌面版

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
MCP Libsql 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Libsql 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Libsql 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Libsql 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Libsql 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Libsql 能提供哪些能力?

资料显示能力标签包括 数据分析、安全协议、TypeScript、Claude、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-18。