TerraCo89/mcp-server-mssql
If you are the rightful owner of mcp-server-mssql and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
This project provides a Model Context Protocol (MCP) server that allows AI agents to interact with Microsoft SQL Server databases using Node.js and TypeScript.
MCP Server for Microsoft SQL Server (Node.js/TypeScript)
This project provides a Model Context Protocol (MCP) server that allows AI agents to interact with Microsoft SQL Server databases. This version is implemented in Node.js and TypeScript.
Features
- Connects directly to a single MSSQL database instance configured via environment variables.
- Provides tools for:
- Listing tables (
list_tables). - Retrieving table schemas (
get_table_schema). - Performing CRUD operations (
read_table_rows,create_table_records,update_table_records,delete_table_records).
- Listing tables (
Prerequisites
- Node.js (v18 or later recommended)
- npm (usually comes with Node.js)
- Access to a Microsoft SQL Server instance.
- Necessary MSSQL ODBC drivers installed on the machine running the server.
Installation
- Clone the repository:
git clone <repository-url> cd mcp-server-mssql - Install dependencies:
npm install
Configuration
- Environment Variables: Configuration is handled entirely through environment variables.
- Copy
.env.exampleto.env. - Fill in the required MSSQL connection details:
MSSQL_HOSTMSSQL_PORT(defaults to 1433 if not set)MSSQL_USERMSSQL_PASSWORDMSSQL_DATABASE
- Optionally configure other MSSQL options (
MSSQL_DRIVER,MSSQL_ENCRYPT,MSSQL_TRUST_SERVER_CERTIFICATE) and logging (LOG_LEVEL) as described in.env.example.
- Copy
Usage
- Build the TypeScript code:
npm run build - Run the server:
Alternatively, for development:
npm startnpm run dev - Connect via MCP Client: Configure your MCP client (e.g., Roo) to connect to this server using stdio.
Tools
(Detailed descriptions of the tools can be found in the server's ListTools response)
list_tablesget_table_schemaread_table_rowscreate_table_recordsupdate_table_recordsdelete_table_records
Development
(Add details about running tests, linting, etc. later)
License
[MIT] - (Or your chosen license)