Microsoft SQL Server 데이터베이스에 연결하는 모델 Context Protocol (MCP) 서버. 이 서버는 SQL 쿼리를 실행하고 데이터베이스 연결을 관리하기위한 도구를 제공합니다.

버전 공지사항: 이 프로젝트는 Model Context Protocol SDK 1.9.0을 사용하도록 업그레이드되었습니다. 자세한 내용은 UPGRADE.md를 참조하십시오.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 MSSQL MCP Server를 자동으로 설치하십시오.

수동 설치

사용법

MCP 설정 설정 파일에 서버를 추가:

도구

태그

MSSQL 데이터베이스에서 SQL 쿼리를 실행합니다.

모수

• connectionString (문자, 선택): 전체 연결 문자열 (개인 매개 변수에 따라)
• host (문자, 선택): 데이터베이스 서버 hostname
• port (숫자, 선택): 데이터베이스 서버 포트 (과태: 1433)
• database (문자, 선택): 데이터베이스 이름 (과태: master)
• username (문자, 선택): Database 사용자 이름
• password (문자, 선택): 데이터베이스 암호
• query (string, required): SQL 쿼리 수행
• encrypt (boolean, 선택 사항) : 암호화 (기본값 : false)
• trustServerCertificate (불린, 옵션): Trust 서버 인증서 (기본값: true)

MSSQL MCP Server

A Model Context Protocol (MCP) server for connecting to Microsoft SQL Server databases. This server provides tools for executing SQL queries and managing database connections.

Version Notice: This project has been upgraded to use Model Context Protocol SDK 1.9.0. See UPGRADE.md for details.

Installation

Installing via Smithery

To install MSSQL MCP Server for Claude Desktop automatically via Smithery:

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

Manual Installation

npm install mssql-mcp-server

Usage

Add the server to your MCP settings configuration file:

{
  "mcpServers": {
    "mssql": {
      "command": "mssql-mcp-server",
      "env": {
        "MSSQL_CONNECTION_STRING": "Server=localhost;Database=master;User Id=sa;Password=yourpassword;",
        // Or individual connection parameters:
        "MSSQL_HOST": "localhost",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "master",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "yourpassword",
        "MSSQL_ENCRYPT": "false",
        "MSSQL_TRUST_SERVER_CERTIFICATE": "true"
      }
    }
  }
}

Tools

query

Execute a SQL query on a MSSQL database.

Parameters

• connectionString (string, optional): Full connection string (alternative to individual parameters)
• host (string, optional): Database server hostname
• port (number, optional): Database server port (default: 1433)
• database (string, optional): Database name (default: master)
• username (string, optional): Database username
• password (string, optional): Database password
• query (string, required): SQL query to execute
• encrypt (boolean, optional): Enable encryption (default: false)
• trustServerCertificate (boolean, optional): Trust server certificate (default: true)

Either connectionString OR (host + username + password) must be provided.

Example

const result = await use_mcp_tool({
  server_name: 'mssql',
  tool_name: 'query',
  arguments: {
    host: 'localhost',
    username: 'sa',
    password: 'yourpassword',
    query: 'SELECT * FROM Users',
  },
});

Running the Server

Local Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Run the built server
npm start

Using Docker

# Build and start services (SQL Server + MCP server)
docker-compose up

# Or just build the Docker image
docker build -t mssql-mcp-server .

Testing

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

Running evals