Skip to content

Conversation

hlgr360
Copy link

@hlgr360 hlgr360 commented Jul 10, 2025

Summary

This PR adds comprehensive authentication documentation and enhances the MCP server to support multiple authentication methods for connecting to MSSQL databases.

Changes Made

Documentation (README.md)

  • Added detailed "Authentication Configuration" section with three supported methods:
    • Azure Active Directory (default) - for Azure SQL Database
    • SQL Server Authentication - for traditional SQL Server instances
    • Windows Authentication (NTLM) - for on-premises domain authentication
  • Provided complete configuration examples for each authentication method
  • Organized configuration parameters into "Common" and "Authentication-Specific" sections
  • Updated all MCP configuration examples to be consistent
  • Added environment variable documentation for all authentication methods

Code Enhancement (src/index.ts)

  • Enhanced createSqlConfig() function to support multiple authentication methods
  • Added configurable authentication via AUTH_METHOD environment variable
  • Implemented proper token management and connection reuse for Azure AD
  • Added support for SQL Server and Windows authentication methods
  • Improved connection handling for different authentication types

Environment Variables Added

  • AUTH_METHOD: Specifies authentication method (azure-ad, sql, windows)
  • SQL_USERNAME & SQL_PASSWORD: For SQL Server authentication
  • USERNAME, PASSWORD & DOMAIN: For Windows authentication

Benefits

  • Provides flexibility for different deployment scenarios
  • Maintains backward compatibility (defaults to Azure AD)
  • Improves security by supporting appropriate auth methods per environment
  • Clear documentation for easy setup and configuration

Testing

  • Tested with MS SQL Server for SQL Server Auth
  • Code structure supports SQL Server and Windows auth (requires appropriate environment for testing)

- Add detailed authentication configuration section to README
- Document Azure AD (default), SQL Server, and Windows authentication methods
- Include complete configuration examples for each authentication type
- Organize configuration parameters by common and auth-specific
- Update existing MCP configuration examples
- Enhance index.ts with multi-authentication support
- Add environment variable documentation for all auth methods
@maxtheobaldd
Copy link

thank you so much i was extremely confused

@JakobStadlhuber
Copy link

please merge

@AV25242 AV25242 requested a review from Copilot August 21, 2025 17:31
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds comprehensive authentication documentation and enhances the MCP server to support multiple authentication methods (Azure Active Directory, SQL Server Authentication, and Windows Authentication) for connecting to MSSQL databases.

  • Enhanced authentication system to support three different methods with configurable selection
  • Added comprehensive documentation with detailed configuration examples for each authentication method
  • Implemented proper token management and connection reuse logic for different authentication types

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

File Description
src/index.ts Enhanced createSqlConfig() function to support multiple authentication methods and improved connection handling
README.md Added detailed authentication configuration section with examples for all three supported methods

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@infobric-stanislav-kondriukov

@hlgr360 please fix Copilot comments. I hope that after this person who maintain Azure-Samples will review and approve this change. We realy need this mcp to be able to connect to local instances of mssql server.

@laureanraybahala
Copy link

Hi @stuartpa @AV25242

Are there any plans of accepting this specific PR contribution? Could you please review?

Many thanks!

@hlgr360
Copy link
Author

hlgr360 commented Sep 30, 2025 via email

@hlgr360
Copy link
Author

hlgr360 commented Oct 3, 2025

All comments resolved

@hlgr360 hlgr360 closed this Oct 3, 2025
@hlgr360 hlgr360 reopened this Oct 3, 2025
@hlgr360
Copy link
Author

hlgr360 commented Oct 3, 2025

Please merge pull request

@adminIngentis
Copy link

I did my part @laureanraybahala :)

@adminIngentis
Copy link

@stuartpa @AV25242, can you please review and merge?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants