SQLite数据库服务

一个为Claude AI提供SQLite数据库访问和操作功能的Model Context Protocol (MCP)服务器。

  • by TIMBOTGPT
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 timbotgpt/sqlite-mcp

使用说明

SQLite MCP服务器

一个模型上下文协议(MCP)服务器,为Claude AI提供SQLite数据库访问和操作。

特性

  • connect_database:连接到SQLite数据库文件
  • execute_query:运行SQL查询(SELECT、INSERT、UPDATE、DELETE等)
  • get_schema:获取完整的数据库架构信息
  • list_tables:列出数据库中的所有表
  • describe_table:获取包括列和索引在内的详细表信息
  • list_connections:显示所有活动的数据库连接
  • close_connection:关闭数据库连接
  • 支持多个同时进行的数据库连接
  • 准备语句参数绑定
  • 全面的错误处理

安装

快速安装

npm install -g sqlite-mcp-server

来源

  1. 克隆存储库:

    git clone https://github.com/TIMBOTGPT/sqlite-mcp.git
    cd sqlite-mcp
    
  2. 安装依赖项:

    npm install
    
  3. 构建项目:

    npm run build
    
  4. 测试服务器:

    npm start
    

使用Claude Desktop

将此服务器添加到您的Claude Desktop MCP配置中(claude_desktop_config.json):

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "sqlite-mcp-server"],
      "description": "SQLite database operations"
    }
  }
}

或者,如果在本地安装:

{
  "mcpServers": {
    "sqlite": {
      "command": "node",
      "args": ["/path/to/sqlite-mcp/dist/index.js"],
      "env": {
        "DATABASE_PATH": "/path/to/your/databases"
      },
      "description": "SQLite database operations"
    }
  }
}

可用工具

connect_database

连接到SQLite数据库文件。

参数:

  • path (必填):SQLite数据库文件的路径
  • alias (可选):连接别名(默认为文件名)

例子:

{
  "name": "connect_database",
  "arguments": {
    "path": "/path/to/database.db",
    "alias": "mydb"
  }
}

execute_query

在连接的数据库上执行SQL查询。

参数:

  • database (必需):数据库别名或路径
  • query (必填):要执行的SQL查询
  • params (可选):准备语句的参数数组

例子:

{
  "name": "execute_query",
  "arguments": {
    "database": "mydb",
    "query": "SELECT * FROM users WHERE age > ?",
    "params": [25]
  }
}

get_schema

获取数据库的完整架构。

参数:

  • database (必需):数据库别名或路径

list_tables

列出数据库中的所有表。

参数:

  • database (必需):数据库别名或路径

describe_table

获取特定表格的详细信息。

参数:

  • database (必需):数据库别名或路径
  • table (必填):表名

list_connections

显示所有活动的数据库连接。

close_connection

关闭数据库连接。

参数:

  • database (必需):要关闭的数据库别名或路径

需求

  • Node.js 18+
  • SQLite3
  • 支持MCP的Claude桌面

安全

  • 在尝试连接之前验证文件是否存在
  • 正确的连接管理和清理
  • 防止SQL注入的参数绑定
  • 全面的错误处理

发展

# Install dependencies
npm install

# Build TypeScript
npm run build

# Development with auto-reload
npm run dev

# Run tests
npm test

许可证

MIT许可证-有关详细信息,请参阅许可证文件

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用,添加测试
  5. 提交拉取请求

支持

有关问题和疑问,请使用 GitHub问题 页面。