只读数据库查询服务

一个用于Turso/libSQL数据库的只读查询服务,支持AI助手安全查询数据而无需担心数据被修改。

  • by PramaAditya
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 PramaAditya/turso-mcp

使用说明

电子邮件@prama13/turso-mcp

用于对Turso/libSQL数据库进行只读查询的模型上下文协议(MCP)服务器。该服务器使Claude、Roo和Cline等人工智能助手能够安全地查询您的Turso数据库,而不会有任何数据修改的风险。

特性

  • 🔒 只读操作 -只允许SELECT查询
  • 📊 表格浏览 -列出所有表并查看其模式
  • 🚫 注重安全 -阻止所有写入操作(INSERT、UPDATE、DELETE、DROP、CREATE、ALTER等)
  • 🔌 MCP协议 -与任何MCP客户端兼容
  • 📦 易于设置 -与合作 npx -无需安装

安装

无需安装!直接使用 npx:

npx @prama13/turso-mcp

配置

对于Roo/Cline

添加到MCP设置中:

{
  "mcpServers": {
    "turso": {
      "command": "npx",
      "args": ["-y", "@prama13/turso-mcp"],
      "env": {
        "TURSO_DATABASE_URL": "libsql://your-database.turso.io",
        "TURSO_AUTH_TOKEN": "your-auth-token"
      }
    }
  }
}

适用于克劳德桌面

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "turso": {
      "command": "npx",
      "args": ["-y", "@prama13/turso-mcp"],
      "env": {
        "TURSO_DATABASE_URL": "libsql://your-database.turso.io",
        "TURSO_AUTH_TOKEN": "your-auth-token"
      }
    }
  }
}

获取您的Turso证书

  1. 安装Turso CLI:
curl -sSfL https://get.tur.so/install.sh | bash
  1. 注册/登录:
turso auth signup
# or
turso auth login
  1. 创建数据库:
turso db create my-database
  1. 获取您的数据库URL:
turso db show my-database --url
  1. 创建身份验证令牌:
turso db tokens create my-database

可用工具

怎么翻译

对Turso数据库运行只读SQL查询。

参数:

  • sql (字符串,必填)-要执行的SQL查询(仅限SELECT)

例子:

SELECT * FROM users WHERE id = 1;

可用资源

服务器将所有数据库表作为资源公开:

  • 列出表格 -自动发现数据库中的所有表
  • 表架构 -查看每个表的列定义

安全

此服务器实现了多层安全性以确保只读访问:

  1. 关键字过滤 -阻止包含write关键字的SQL语句:

    • 插入、更新、删除、删除、创建、更改
    • 替换、截断、连接、分离
    • PRAGMA、重新索引、真空、分析
  2. 基于环境的凭据 -数据库凭据通过环境变量传递,从不在代码中传递

发展

# Clone the repository
git clone https://github.com/PramaAditya/turso-mcp.git
cd turso-mcp

# Install dependencies
npm install

# Build
npm run build

# Test locally
TURSO_DATABASE_URL="libsql://..." TURSO_AUTH_TOKEN="..." node dist/index.js

许可证

麻省理工学院

作者

prama13

相关