MCP Database Server

MCP Database Server

site icon
2025.04.14 5
TypeScript数据库服务数据管理数据库
MCP Database Server 是一个基于 Model Context Protocol (MCP) 的数据库访问服务,为 Claude 提供对 SQLite 和 SQL Server 数据库的访问能力。该服务支持多种数据库操作,包括查询、修改、表结构管理等,并提供了丰富的工具集来满足不同的数据库操作需求。
View on GitHub

Overview

基本能力

产品定位

MCP Database Server 是一个数据库访问中间件,旨在为 Claude 提供便捷的数据库操作能力。

核心功能

  1. 支持 SQLite 和 SQL Server 数据库
  2. 提供多种数据库操作工具:
  3. 数据查询 (read_query)
  4. 数据修改 (write_query)
  5. 表结构管理 (create_table, alter_table, drop_table)
  6. 表信息查询 (list_tables, describe_table)
  7. 数据导出 (export_query)
  8. 业务洞察管理 (append_insight, list_insights)

适用场景

  1. Claude 需要访问本地或远程数据库的场景
  2. 需要执行复杂数据库操作的自动化任务
  3. 数据库管理和维护工作
  4. 数据分析和报表生成

工具列表

工具 描述
read_query 执行 SELECT 查询读取数据
write_query 执行 INSERT/UPDATE/DELETE 操作
create_table 创建新表
alter_table 修改表结构
drop_table 删除表
list_tables 获取所有表列表
describe_table 查看表结构信息
export_query 导出查询结果为 CSV/JSON
append_insight 添加业务洞察
list_insights 列出所有业务洞察

常见问题

  1. 连接 SQL Server 需要提供正确的服务器名称和数据库名称
  2. 删除表操作需要设置 confirm=true 安全标志
  3. 需要 Node.js 18+ 环境

使用教程

使用依赖

  1. 安装 Node.js 18+ 环境
  2. 对于 SQL Server 连接,需要 SQL Server 2012 或更高版本

安装教程

  1. 克隆仓库:
git clone https://github.com/executeautomation/database-server.git
cd database-server
  1. 安装依赖:
npm install
  1. 构建项目:
npm run build

或者全局安装:

npm install -g @executeautomation/database-server

调试方式

  1. 开发模式运行:
npm run dev
  1. 监听文件变化:
npm run watch
  1. 测试 SQLite 连接:
node dist/src/index.js /path/to/your/database.db
  1. 测试 SQL Server 连接:
node dist/src/index.js --sqlserver --server <server-name> --database <database-name> [--user <username> --password <password>]

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。