Dotnet Sqlserver MCP

SQL Server MCP服务器

A.基于.NET的模型上下文协议（MCP）服务器为SQL server数据库检查、查询和调试提供了6个基本工具。


快速开始

安装方式如下。NET工具（推荐）

dotnet tool install --global SqlServerLocalMcp

然后在Claude Desktop中进行配置（请参阅下面的配置）。

或从源代码构建

cd SqlServerMcp
dotnet build

本地测试

export SQL_SERVER_CONNECTION_STRING="Server=localhost;Database=MyDB;Trusted_Connection=True;TrustServerCertificate=True;"
dotnet run

Claude桌面设置

编辑您平台的配置文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

选项1：使用已安装。NET工具（推荐）

{
  "mcpServers": {
    "sqlserver": {
      "command": "sqlserverlocal-mcp",
      "args": [],
      "env": {
        "SQL_SERVER_CONNECTION_STRING": "Server=localhost;Database=MySqlDb;Trusted_Connection=True;TrustServerCertificate=True;"
      }
    }
  }
}

选项2：从源代码运行

{
  "mcpServers": {
    "sqlserver": {
      "command": "dotnet",
      "args": ["run", "--project", "C:\\src\\dotnet-sqlserver-mcp\\SqlServerMcp"],
      "env": {
        "SQL_SERVER_CONNECTION_STRING": "Server=localhost;Database=MySqlDb;Trusted_Connection=True;TrustServerCertificate=True;"
      }
    }
  }
}

重要提示：

• 使用绝对路径
• Windows：使用 \\ 用于睫毛或 / 用于正斜杠
• macOS/Linux：使用正斜杠
• 编辑后重新启动Claude Desktop

Claude CLI的设置（代码编辑器）

选项1：使用已安装。NET工具（推荐）

claude mcp add --transport stdio sqlserver \
  --env SQL_SERVER_CONNECTION_STRING="Server=localhost;Database=MySqlDb;Trusted_Connection=True;TrustServerCertificate=True;" \
  -- sqlserverlocal-mcp

选项2：从源代码运行

窗户：

claude mcp add --transport stdio sqlserver ^
  --env SQL_SERVER_CONNECTION_STRING="Server=localhost;Database=MySqlDb;Trusted_Connection=True;TrustServerCertificate=True;" ^
  -- cmd /c dotnet run --project C:\src\dotnet-sqlserver-mcp\SqlServerMcp

macOS/Linux：

claude mcp add --transport stdio sqlserver \
  --env SQL_SERVER_CONNECTION_STRING="Server=localhost;Database=MySqlDb;Trusted_Connection=True;TrustServerCertificate=True;" \
  -- dotnet run --project /path/to/dotnet-sqlserver-mcp/SqlServerMcp

附加选项：

claude mcp add --transport stdio sqlserver \
  --env SQL_SERVER_CONNECTION_STRING="Server=localhost;Database=MyDB;Trusted_Connection=True;" \
  --env SQL_SERVER_READONLY="true" \
  --env SQL_SERVER_MAX_ROWS="500" \
  -- dotnet run --project /path/to/SqlServerMcp

管理命令：

claude mcp list              # List all servers
claude mcp get sqlserver     # View server details
claude mcp remove sqlserver  # Remove server

连接串

配置选项

添加到 env 章节：

带有选项的示例：

{
  "mcpServers": {
    "sqlserver": {
      "command": "dotnet",
      "args": ["run", "--project", "C:\\src\\dotnet-sqlserver-mcp\\SqlServerMcp"],
      "env": {
        "SQL_SERVER_CONNECTION_STRING": "Server=localhost;Database=MyDB;Trusted_Connection=True;TrustServerCertificate=True;",
        "SQL_SERVER_READONLY": "true",
        "SQL_SERVER_MAX_ROWS": "500",
        "SQL_SERVER_ALLOW_PROCEDURE_EXECUTION": "true",
        "SQL_SERVER_ALLOWED_PROCEDURES": "dbo.GetOrders,reporting.*"
      }
    }
  }
}

可用工具（6）

核心必备工具

用法示例

问：

• “列出数据库中的所有表”→ Uses execute_sql 使用INFORMATION_SCHEMA查询
• “描述订单表结构”→ Uses describe_table
• “哪些外键引用了Customers表？”→ Uses execute_sql 使用sys.foreign_keys查询
• “显示前10个最慢的查询”→ Uses get_query_stats
• “在Users表中查找重复的电子邮件地址”→ Uses execute_sql 与GROUP BY/HAVING合作
• “显示GetCustomerOrders存储过程的代码”→ Uses get_procedure_definition

安全

只读模式（默认）： 只允许SELECT查询。集 SQL_SERVER_READONLY=false 以允许修改。

存储过程： 需要 SQL_SERVER_ALLOW_PROCEDURE_EXECUTION=true 以及可选的同种异体。

调整限制：

"env": {
  "SQL_SERVER_MAX_ROWS": "100",
  "SQL_SERVER_DEFAULT_TIMEOUT": "60"
}

项目结构

SqlServerMcp/
├── Program.cs              # Entry point
├── Configuration/          # Config models
├── Models/                 # Data models
├── Services/              # SqlService, ResultFormatter
└── Tools/                 # 4 tool classes (6 essential tools)
    ├── QueryTools.cs       # execute_sql
    ├── SchemaTools.cs      # describe_table, list_stored_procedures
    ├── DiagnosticTools.cs  # get_connections, get_query_stats
    └── ProcedureTools.cs   # get_procedure_definition

发展

添加新工具： 在中创建方法 Tools/*.cs 随着 [McpServerTool] 属性：

[McpServerTool]
[Description("Your tool description")]
public async Task YourTool(
    [Description("Parameter description")] string parameter)
{
    // Implementation
}

MCP检验员测试：

npx @modelcontextprotocol/inspector dotnet run --project SqlServerMcp

需求

• .NET 8 SDK
• SQL Server（本地、Azure SQL或Docker）
• Claude桌面或Claude CLI

许可证

看 许可证 文件。

资源

• MCP规范
• MCP C#SDK
• SQL Server文档