DatabaseMcpServer.win-x64 0.1.0-beta

数据库操作 MCP 服务器

一个功能强大的数据库操作 MCP (Model Context Protocol) 服务器，支持多种主流数据库。通过环境变量配置连接信息，让 AI 助手能够安全、便捷地执行数据库操作。

✨ 特性

• 🗄️ 多数据库支持：MySQL、SQL Server、SQLite、PostgreSQL、Oracle
• 🔒 安全防护：内置危险操作检测，防止意外的破坏性操作
• 🚀 高性能：基于 SqlSugar ORM，提供高效的数据库访问
• 📦 自包含部署：无需在目标机器上安装 .NET 运行时
• 🌍 跨平台支持：支持 Windows、macOS、Linux 多种架构
• 🔧 环境变量配置：通过环境变量全局配置，无需每次传参
• 💾 事务支持：支持多条 SQL 命令的事务操作
• 🛡️ 参数化查询：防止 SQL 注入攻击

📋 功能清单

🔌 连接与配置管理

• test_connection - 测试数据库连接
• get_database_config - 获取当前数据库配置信息
• validate_configuration - 验证数据库配置是否正确

🔍 数据库架构查询

• get_data_base_list - 获取所有数据库名称
• get_table_info_list - 获取所有表名
• get_view_info_list - 查询所有视图
• get_column_infos_by_table_name - 根据表名获取字段信息
• get_table_schema - 获取表的完整结构信息（列、主键、索引、自增列）
• get_is_identities - 获取自增列
• get_primaries - 获取主键
• get_index_list - 获取所有索引名字集合
• get_proc_list - 获取存储过程名字集合
• get_func_list - 获取函数集合
• get_trigger_names - 根据表名获取触发器集合
• get_db_types - 获取数据库类型集合

🔎 存在性检查

• is_any_table - 判断表是否存在
• is_any_column - 判断列是否存在
• is_primary_key - 判断主键是否存在
• is_identity - 判断自增是否存在
• is_any_constraint - 判断约束是否存在
• is_any_index - 判断索引是否存在
• is_any_table_remark - 判断是否存在表描述

📊 数据查询工具

基础查询

• sql_query - 执行 SQL 查询并返回强类型实体集合（支持参数化查询）
• sql_query_single - 执行 SQL 查询并返回单条记录
• get_data_reader - 获取 DataReader 数据（自动处理释放）

高级查询

• get_data_set_all - 获取多个结果集，支持一次执行多个查询
• sql_query_multiple - 执行查询并返回两个结果集
• sql_query_with_in_parameter - 处理 IN 参数查询，支持数组参数

标量值查询

• get_scalar - 获取首行首列的值（标量值）
• get_string - 获取首行首列的字符串值
• get_int - 获取首行首列的整数值
• get_long - 获取首行首列的长整数值
• get_double - 获取首行首列的双精度浮点数值
• get_decimal - 获取首行首列的十进制数值
• get_date_time - 获取首行首列的日期时间值

✏️ 数据操作工具

• execute_command - 执行 SQL 命令（INSERT、UPDATE、DELETE）
• insert_data - 向表中插入数据
• update_data - 更新表中的数据
• delete_data - 从表中删除数据

🔄 事务与批量操作

• execute_transaction - 执行包含多条 SQL 命令的事务
• batch_execute_commands - 批量执行 SQL 命令（使用长连接优化性能）

📞 存储过程调用

• call_stored_procedure - 调用存储过程（简单用法）
• call_stored_procedure_with_output - 调用带有输出参数的存储过程

🛠️ 数据库架构操作（高风险）

表操作

• drop_table - 删除表
• truncate_table - 清空表
• backup_table - 备份表
• rename_table - 重命名表

列操作

• add_column - 添加列
• update_column - 更新列
• drop_column - 删除列
• rename_column - 重命名列

约束和索引操作

• add_primary_key - 添加主键
• drop_constraint - 删除约束
• create_index - 创建索引或唯一约束

默认值和注释

• add_default_value - 添加默认值
• add_table_remark - 添加表描述
• delete_table_remark - 删除表描述
• add_column_remark - 添加列描述
• delete_column_remark - 删除列描述

存储过程、函数、视图操作

• drop_view - 删除视图
• drop_func - 删除函数
• drop_proc - 删除存储过程

🔧 SQL Server 特殊支持

• execute_command_with_go - 执行包含 GO 语句的 SQL Server 脚本

🚀 快速开始

本地开发测试

1. 克隆项目

git clone https://github.com/ttcc666/DatabaseMcpServer.git
cd DatabaseMcpServer

2. 配置 MCP 客户端

在你的 IDE 中创建 MCP 配置文件，并通过 env 字段设置数据库连接信息：

VS Code (<WORKSPACE>/.vscode/mcp.json):

{
  "mcpServers": {
    "DatabaseMcpServer": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "D:/Demo/my-mcp/DatabaseMcpServer"
      ],
      "env": {
        "DB_CONNECTION_STRING": "Server=localhost;Database=mydb;User=root;Password=123456;",
        "DB_TYPE": "MySql"
      }
    }
  }
}

Visual Studio (<SOLUTION>/.mcp.json):

{
  "mcpServers": {
    "DatabaseMcpServer": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "D:\\Demo\\my-mcp\\DatabaseMcpServer"
      ],
      "env": {
        "DB_CONNECTION_STRING": "Server=localhost;Database=mydb;User=root;Password=123456;",
        "DB_TYPE": "MySql"
      }
    }
  }
}

3. 环境变量说明

4. 测试服务器

在 Copilot Chat 中尝试以下命令（无需提供连接信息）：

• "测试数据库连接"
• "列出当前数据库的所有表"
• "查询 users 表的所有数据"
• "获取 products 表的结构信息"

📦 从 NuGet 安装

1. 在 IDE 中配置

VS Code (<WORKSPACE>/.vscode/mcp.json):

{
  "mcpServers": {
    "DatabaseMcpServer": {
      "command": "dnx",
      "args": [
        "DatabaseMcpServer",
        "--version",
        "0.1.0-beta",
        "--yes"
      ],
      "env": {
        "DB_CONNECTION_STRING": "Server=localhost;Database=mydb;User=root;Password=123456;",
        "DB_TYPE": "MySql"
      }
    }
  }
}

Visual Studio (<SOLUTION>/.mcp.json):

{
  "mcpServers": {
    "DatabaseMcpServer": {
      "command": "dnx",
      "args": [
        "DatabaseMcpServer",
        "--version",
        "0.1.0-beta",
        "--yes"
      ],
      "env": {
        "DB_CONNECTION_STRING": "Server=localhost;Database=mydb;User=root;Password=123456;",
        "DB_TYPE": "MySql"
      }
    }
  }
}

💻 使用示例

示例 1：测试连接

测试数据库连接

返回：

{
  "success": true,
  "message": "连接成功",
  "connected": true,
  "databaseType": "MySql"
}

示例 2：查询数据

查询 users 表中年龄大于 18 岁的用户

AI 会自动使用环境变量中的连接信息执行查询。

示例 3：插入数据

向 products 表插入一条新记录：
{
  "name": "iPhone 15",
  "price": 5999,
  "stock": 100
}

示例 4：获取表结构

获取 users 表的完整结构信息

示例 5：事务操作

执行以下事务操作：
1. 从账户 A 扣除 100 元
2. 向账户 B 增加 100 元

示例 6：验证配置

验证数据库配置是否正确

返回：

{
  "configured": true,
  "databaseType": "MySql",
  "connectionString": "Server=localhost;Database=mydb;User=root;Password=****;",
  "message": "配置有效"
}

示例 7：多结果集查询

使用 sql_query_multiple 查询用户信息和订单统计

AI 会执行类似以下的查询：

SELECT * FROM users WHERE status = 1; 
SELECT COUNT(*) as order_count, SUM(amount) as total_amount FROM orders WHERE user_id IN (SELECT id FROM users WHERE status = 1)

示例 8：存储过程调用

调用存储过程 sp_get_user_summary，传入用户ID 1，并获取输出参数 total_orders

AI 会使用 call_stored_procedure_with_output 工具处理带输出参数的存储过程。

示例 9：批量操作

批量更新多个用户的状态为激活状态

AI 会使用 batch_execute_commands 工具优化批量操作性能。

示例 10：IN 参数查询

查询 ID 在 [1, 2, 3, 5, 8] 中的订单信息

AI 会使用 sql_query_with_in_parameter 工具处理数组参数。

🔒 安全特性

危险操作检测

服务器会自动检测并阻止以下危险操作：

• DROP TABLE - 删除表
• DROP DATABASE - 删除数据库
• TRUNCATE TABLE - 截断表
• ALTER TABLE - 修改表结构
• CREATE TABLE - 创建表

如需执行这些操作，请使用专门的架构操作工具（如 drop_table, truncate_table 等）。

SQL 注入防护

所有查询和命令都支持参数化查询，示例：

查询年龄大于 18 且城市为北京的用户

AI 会自动生成参数化查询：

{
  "sql": "SELECT * FROM users WHERE age > @age AND city = @city",
  "parameters": "{\"age\":18,\"city\":\"Beijing\"}"
}

敏感信息保护

• 配置信息中的密码会自动隐藏
• 连接字符串在日志中显示为 Password=****

🔧 开发指南

构建项目

# 恢复依赖
dotnet restore

# 构建项目
dotnet build

# 运行项目
dotnet run

# 打包发布
dotnet pack -c Release

支持的平台

默认支持以下平台：

• win-x64 - Windows 64位
• win-arm64 - Windows ARM64
• osx-arm64 - macOS ARM64 (Apple Silicon)
• linux-x64 - Linux 64位
• linux-arm64 - Linux ARM64
• linux-musl-x64 - Alpine Linux 64位

如需添加更多平台，请在 .csproj 文件中修改 <RuntimeIdentifiers> 元素。

添加新工具

1. 在 Tools 目录下创建新的工具类
2. 使用 [McpServerTool] 特性标记方法
3. 使用 [Description] 特性添加中文描述
4. 通过 DatabaseConfigService 获取数据库连接
5. 在 Program.cs 中注册工具：

builder.Services
    .AddMcpServer()
    .WithStdioServerTransport()
    .WithTools<ConnectionTools>()
    .WithTools<SchemaTools>()
    .WithTools<QueryTools>()
    .WithTools<CommandTools>()
    .WithTools<YourNewTools>();  // 添加你的新工具

工具开发示例

using System.ComponentModel;
using ModelContextProtocol.Server;
using DatabaseMcpServer.Services;

namespace DatabaseMcpServer.Tools;

internal class YourNewTools
{
    [McpServerTool]
    [Description("你的工具描述")]
    public string YourMethod(
        [Description("参数描述")] string parameter)
    {
        // 使用全局配置创建数据库客户端
        using var db = DatabaseConfigService.CreateGlobalClient();
        
        // 执行数据库操作
        var result = db.Queryable<YourEntity>().ToList();
        
        // 返回 JSON 结果
        return DatabaseHelper.SerializeResult(new { success = true, data = result });
    }
}

📚 数据库连接字符串示例

MySQL

Server=localhost;Port=3306;Database=mydb;User=root;Password=123456;

SQL Server

Server=localhost;Database=mydb;User Id=sa;Password=123456;

SQLite

Data Source=mydb.db;

PostgreSQL

Host=localhost;Port=5432;Database=mydb;Username=postgres;Password=123456;

Oracle

Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orcl)));User Id=system;Password=123456;

🛠️ 技术栈

• .NET 9.0 - 最新的 .NET 框架
• ModelContextProtocol - MCP 协议 C# SDK
• SqlSugar - 轻量级高性能 ORM
• Microsoft.Extensions.Hosting - 依赖注入和托管服务

📝 发布到 NuGet

发布前检查清单

• 本地测试所有功能
• 更新 .csproj 中的包元数据
  • <PackageId>
  • <PackageVersion>
  • <Description>
  • <Authors>
• 更新 .mcp/server.json
• 更新 README.md
• 添加许可证文件

发布步骤

1. 打包项目

dotnet pack -c Release

2. 发布到 NuGet.org

dotnet nuget push bin/Release/*.nupkg --api-key <your-api-key> --source https://api.nuget.org/v3/index.json

3. 验证发布 访问 NuGet.org 确认包已成功发布。

📖 相关资源

MCP 相关

• MCP 官方文档
• MCP 协议规范
• MCP GitHub 组织
• ModelContextProtocol NuGet 包

IDE 集成

• VS Code 中使用 MCP 服务器
• Visual Studio 中使用 MCP 服务器

.NET MCP 开发

• .NET MCP 服务器开发指南
• 配置输入参数

🎯 核心优势

为什么使用环境变量配置？

1. 简化调用 - 所有工具方法无需传入连接参数
2. 集中管理 - 在一个地方配置，全局使用
3. 安全性高 - 敏感信息不会在工具调用中暴露
4. 易于切换 - 修改配置文件即可切换数据库环境
5. 符合最佳实践 - 遵循 12-Factor App 配置原则

对比传统方式

传统方式（每次都要传参）：

查询 users 表，使用连接字符串：Server=localhost;Database=mydb;User=root;Password=123456;，数据库类型：MySql

现在的方式（无需传参）：

查询 users 表

🤝 贡献

欢迎贡献代码、报告问题或提出新功能建议！

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

💬 反馈

如果你对这个项目有任何反馈，请参与 简短调查。

⚠️ 免责声明

• 本项目目前处于早期预览阶段
• 请在生产环境中谨慎使用
• 始终备份重要数据
• 确保正确配置安全设置
• 不要在公共仓库中提交包含真实密码的配置文件

🙏 致谢

• Anthropic - MCP 协议的创建者
• SqlSugar - 优秀的 ORM 框架
• .NET 团队 - 强大的开发平台

注意：

1. 请将文档中的占位符（如 GitHub 用户名、包 ID 等）替换为实际值后再发布
2. 配置文件中的数据库密码仅用于示例，请使用你自己的安全凭据
3. 建议使用 .gitignore 忽略包含敏感信息的配置文件