🚀 MCP SQLite 服务器

Node.js 实现的模型上下文协议（Model Context Protocol）SQLite 服务器，基于官方 Python 版本 参考实现。此版本为无法使用 Python 的 UVX 运行器的环境提供了一个基于 npx 的替代方案，例如 LibreChat。

🚀 快速开始

本部分将介绍如何安装和配置 MCP SQLite 服务器，以使其与 Claude Desktop 结合使用。

✨ 主要特性

• 基于 Node.js 实现，为无法使用 Python 的环境提供替代方案。
• 与官方 Python 版本的参考实现兼容。
• 支持与 Claude Desktop 集成。

📦 安装指南

使用 Smithery 安装

通过 Smithery 自动安装 MCP SQLite 服务器以支持 Claude Desktop：

npx -y @smithery/cli install mcp-server-sqlite-npx --client claude

手动安装

将以下内容添加到 claude_desktop_config.json 中：

{
  "mcpServers": {
    "sqlite": {
      "command": "/absolute/path/to/npx",
      "args": [
        "-y",
        "mcp-server-sqlite-npx",
        "/absolute/path/to/database.db"
      ],
      "env": {
        "PATH": "/absolute/path/to/executables",
        "NODE_PATH": "/absolute/path/to/node_modules"
      }
    }
  }
}

使用 nvm 在 macOS 上的完整示例：

{
  "mcpServers": {
    "sqlite": {
      "command": "/Users/{username}/.nvm/versions/node/v22.12.0/bin/npx",
      "args": [
        "-y",
        "mcp-server-sqlite-npx",
        "/Users/{username}/projects/database.db"
      ],
      "env": {
        "PATH": "/Users/{username}/.nvm/versions/node/v22.12.0/bin:/usr/local/bin:/usr/bin:/bin",
        "NODE_PATH": "/Users/{username}/.nvm/versions/node/v22.12.0/lib/node_modules"
      }
    }
  }
}

使用 nvm 在 Windows 上的完整示例：

{
  "mcpServers": {
    "sqlite": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": [
        "-y",
        "mcp-server-sqlite-npx",
        "C:\\Users\\{username}\\projects\\database.db"
      ],
      "env": {
        "PATH": "C:\\Program Files\\nodejs;%PATH%",
        "NODE_PATH": "C:\\Program Files\\nodejs\\node_modules"
      }
    }
  }
}

💻 使用示例

与 Claude Desktop 结合使用

使用 Smithery 安装

npx -y @smithery/cli install mcp-server-sqlite-npx --client claude

手动安装

{
  "mcpServers": {
    "sqlite": {
      "command": "/absolute/path/to/npx",
      "args": [
        "-y",
        "mcp-server-sqlite-npx",
        "/absolute/path/to/database.db"
      ],
      "env": {
        "PATH": "/absolute/path/to/executables",
        "NODE_PATH": "/absolute/path/to/node_modules"
      }
    }
  }
}

🔧 技术细节

开发

安装依赖项

npm ci

构建 TypeScript 代码

npm run build

测试

使用 MCP Inspector 测试

可以使用 MCP Inspector 工具 测试服务器：

npx @modelcontextprotocol/inspector node dist/index.js /absolute/path/to/database.db

Connect 后转到 Tools 开始使用服务器。

使用 Claude Desktop 测试

将以下内容添加到 claude_desktop_config.json 中：

{
  "mcpServers": {
    "sqlite": {
      "command": "/absolute/path/to/node",
      "args": [
        "dist/index.js"
      ],
      "env": {}
    }
  }
}

发布版本

在终端中运行以下命令发布新版本：

npm run build && npm version patch -m "Release new version"

📄 许可证

本项目使用 MIT 许可证。