Database Bulk Update

🚀 数据库更新 MCP 服务器

本项目是一个用于从 CSV 和 Excel 文件更新数据库的模型上下文协议（Model Context Protocol）服务器，能够帮助用户便捷地将文件数据更新到数据库中，支持多种文件格式和数据库类型。

✨ 主要特性

工具

• update_database：可使用 CSV/Excel 文件更新数据库。
  • 支持 CSV 和 Excel（.xlsx, .xls）文件格式，方便处理不同来源的数据。
  • 兼容多种数据库类型，包括 PostgreSQL、MySQL、MongoDB、SQLite，满足多样化的数据库需求。
  • 具备可配置的连接设置和表映射，能灵活适应不同的数据库环境。
• create_note：用于创建和管理笔记（用于文档记录）。
  • 可存储有关数据库更新的重要信息，便于后续查阅。
  • 能记录更改和修改，方便跟踪数据库的更新历史。

🚀 快速开始

使用方法

更新数据库

使用 update_database 工具时，需传入如下参数：

{
  "filePath": "/path/to/your/file.csv",
  "databaseType": "PostgreSQL",
  "connectionString": "postgresql://user:pass@localhost:5432/db",
  "tableName": "target_table"
}

支持的数据库类型

• PostgreSQL
• MySQL
• MongoDB
• SQLite

📦 安装指南

要在 Claude Desktop 上使用，请添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "database-updater": {
      "command": "/path/to/database-updater/build/index.js"
    }
  }
}

💻 使用示例

基础用法

以下是使用 update_database 工具更新数据库的示例：

{
  "filePath": "/path/to/your/file.csv",
  "databaseType": "PostgreSQL",
  "connectionString": "postgresql://user:pass@localhost:5432/db",
  "tableName": "target_table"
}

🔧 技术细节

开发

安装依赖

npm install

构建服务器

npm run build

带自动重建开发

npm run watch

调试

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们推荐使用 MCP Inspector：

npm run inspector

Inspector 将提供一个访问浏览器调试工具的 URL，方便进行调试工作。