microsoft_sql_server_mcp_haibt 0.1.0__tar.gz

microsoft_sql_server_mcp_haibt-0.1.0/.dockerignore

@@ -0,0 +1,28 @@
+# Git
+.git
+.gitignore
+
+# Virtual Environment
+venv/
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Logs
+*.log
+
+# Docker
+Dockerfile
+.dockerignore
+docker-compose.yml
+
+# Editor directories and files
+.idea/
+.vscode/
+*.swp
+*.swo

microsoft_sql_server_mcp_haibt-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,120 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Test Python ${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ['3.11', '3.12']
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install system dependencies (Ubuntu)
+      if: matrix.os == 'ubuntu-latest'
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y freetds-dev
+    
+    - name: Install system dependencies (macOS)
+      if: matrix.os == 'macos-latest'
+      run: |
+        brew install freetds
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        pip install -r requirements-dev.txt
+        pip install -e .
+    
+    - name: Lint with ruff
+      run: |
+        pip install ruff
+        ruff check src tests
+    
+    - name: Type check with mypy
+      run: |
+        pip install mypy
+        mypy src --ignore-missing-imports
+    
+    - name: Test with pytest
+      run: |
+        pytest tests -v --tb=short
+      env:
+        MSSQL_SERVER: localhost
+        MSSQL_USER: test
+        MSSQL_PASSWORD: test
+        MSSQL_DATABASE: test
+    
+    - name: Check package build
+      run: |
+        pip install hatch
+        hatch build
+        ls -la dist/
+
+  security-scan:
+    name: Security Scan
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install bandit[toml] safety
+    
+    - name: Run Bandit security scan
+      run: bandit -r src -f json -o bandit-report.json || true
+    
+    - name: Run Safety check
+      run: |
+        pip install -r requirements.txt
+        safety check --json || true
+    
+    - name: Upload security reports
+      uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: security-reports
+        path: |
+          bandit-report.json
+          
+  docker-build:
+    name: Docker Build Test
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+    
+    - name: Build Docker image
+      run: |
+        docker build -t mssql-mcp-server:test .
+    
+    - name: Test Docker image
+      run: |
+        docker run --rm mssql-mcp-server:test python --version

microsoft_sql_server_mcp_haibt-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,88 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      test_pypi:
+        description: 'Publish to Test PyPI first'
+        required: false
+        default: true
+        type: boolean
+
+jobs:
+  build:
+    name: Build distribution packages
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install hatch
+    
+    - name: Build package
+      run: hatch build
+    
+    - name: Store the distribution packages
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+  publish-to-test-pypi:
+    name: Publish to Test PyPI
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.test_pypi == 'true'
+    needs: build
+    runs-on: ubuntu-latest
+    
+    environment:
+      name: test-pypi
+      url: https://test.pypi.org/p/microsoft_sql_server_mcp
+    
+    permissions:
+      id-token: write  # IMPORTANT: mandatory for trusted publishing
+    
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+    
+    - name: Publish to Test PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/
+        skip-existing: true
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && github.event.inputs.test_pypi == 'false')
+    needs: build
+    runs-on: ubuntu-latest
+    
+    environment:
+      name: pypi
+      url: https://pypi.org/p/microsoft_sql_server_mcp
+    
+    permissions:
+      id-token: write  # IMPORTANT: mandatory for trusted publishing
+    
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+    
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

microsoft_sql_server_mcp_haibt-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,59 @@
+name: Create Release
+
+on:
+  push:
+    tags:
+      - 'v*'  # Trigger on version tags like v1.0.0
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release (e.g., 1.0.0)'
+        required: true
+        type: string
+
+jobs:
+  create-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Get all history for changelog
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Generate changelog
+      id: changelog
+      run: |
+        # Generate changelog from git history
+        echo "## What's Changed" > RELEASE_NOTES.md
+        echo "" >> RELEASE_NOTES.md
+        
+        # Get commits since last tag
+        LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+        if [ -z "$LAST_TAG" ]; then
+          git log --pretty=format:"* %s (%h)" >> RELEASE_NOTES.md
+        else
+          git log ${LAST_TAG}..HEAD --pretty=format:"* %s (%h)" >> RELEASE_NOTES.md
+        fi
+        
+        echo "" >> RELEASE_NOTES.md
+        echo "**Full Changelog**: https://github.com/${{ github.repository }}/compare/${LAST_TAG}...v${{ github.event.inputs.version || github.ref_name }}" >> RELEASE_NOTES.md
+    
+    - name: Create Release
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        VERSION="${{ github.event.inputs.version || github.ref_name }}"
+        VERSION="${VERSION#v}"  # Remove 'v' prefix if present
+        
+        gh release create "v${VERSION}" \
+          --title "Release v${VERSION}" \
+          --notes-file RELEASE_NOTES.md \
+          --draft

microsoft_sql_server_mcp_haibt-0.1.0/.github/workflows/security.yml

@@ -0,0 +1,68 @@
+name: Security Scan
+
+on:
+  schedule:
+    - cron: '0 0 * * 1'  # Weekly on Monday
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  security-events: write
+
+jobs:
+  dependency-check:
+    name: Dependency Security Check
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install safety pip-audit
+        pip install -r requirements.txt
+    
+    - name: Run Safety check
+      run: |
+        safety check --json --output safety-report.json || true
+    
+    - name: Run pip-audit
+      run: |
+        pip-audit --format json --output pip-audit-report.json || true
+    
+    - name: Upload security reports
+      uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: dependency-security-reports
+        path: |
+          safety-report.json
+          pip-audit-report.json
+
+  codeql-analysis:
+    name: CodeQL Analysis
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: python
+    
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+    
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3

microsoft_sql_server_mcp_haibt-0.1.0/.gitignore

@@ -0,0 +1,82 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+Thumbs.db
+ehthumbs.db
+
+# Environment variables
+.env
+*.env
+!.env.example
+
+# Logs
+*.log
+
+# Database
+*.db
+*.sqlite
+
+# MCP specific
+mcp-workspace/
+
+# Claude local settings
+.claude/

microsoft_sql_server_mcp_haibt-0.1.0/Dockerfile

@@ -0,0 +1,20 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install system dependencies for pymssql
+RUN apt-get update && apt-get install -y \
+    freetds-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy project files
+COPY . .
+
+# Run the MCP server
+CMD ["python", "-m", "mssql_mcp_server"]

microsoft_sql_server_mcp_haibt-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dana K. Williams
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

microsoft_sql_server_mcp_haibt-0.1.0/Makefile

@@ -0,0 +1,65 @@
+.PHONY: venv install install-dev test lint format clean run docker-build docker-up docker-down docker-test docker-exec
+
+PYTHON := python3
+VENV := venv
+BIN := $(VENV)/bin
+
+venv:
+	$(PYTHON) -m venv $(VENV)
+
+install: venv
+	$(BIN)/pip install -r requirements.txt
+
+install-dev: install
+	$(BIN)/pip install -r requirements-dev.txt
+	$(BIN)/pip install -e .
+
+test: install-dev
+	$(BIN)/pytest -v
+
+lint: install-dev
+	$(BIN)/black --check src tests
+	$(BIN)/isort --check src tests
+	$(BIN)/mypy src tests
+
+format: install-dev
+	$(BIN)/black src tests
+	$(BIN)/isort src tests
+
+clean:
+	rm -rf $(VENV) __pycache__ .pytest_cache .coverage
+	find . -type d -name "__pycache__" -exec rm -rf {} +
+	find . -type d -name "*.egg-info" -exec rm -rf {} +
+	find . -type f -name "*.pyc" -delete
+
+run: install
+	$(BIN)/python -m mssql_mcp_server
+
+# Docker commands
+docker-build:
+	docker-compose build
+
+docker-up:
+	docker-compose up -d
+
+docker-down:
+	docker-compose down
+
+docker-test:
+	docker-compose exec mcp_server pytest -v
+
+docker-exec:
+	docker-compose exec mcp_server bash
+
+# Test MSSQL connection
+test-connection:
+	$(PYTHON) test_connection.py --server $${MSSQL_SERVER:-localhost} --port $${HOST_SQL_PORT:-1434} --user $${MSSQL_USER:-sa} --password $${MSSQL_PASSWORD:-StrongPassword123!} --database $${MSSQL_DATABASE:-master}
+
+# Set environment variables for testing
+test-env:
+	@echo "Export your database credentials before running tests:"
+	@echo "export MSSQL_SERVER=your_server"
+	@echo "export MSSQL_PORT=1433"
+	@echo "export MSSQL_USER=your_username"
+	@echo "export MSSQL_PASSWORD=your_password"
+	@echo "export MSSQL_DATABASE=your_database"

microsoft_sql_server_mcp_haibt-0.1.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: microsoft_sql_server_mcp_haibt
+Version: 0.1.0
+Summary: A Model Context Protocol (MCP) server that enables secure interaction with Microsoft SQL Server databases.
+Author-email: Richard Han <noreply@example.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,database,mcp,mssql,sql-server
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pymssql>=2.2.8
+Description-Content-Type: text/markdown
+
+# Microsoft SQL Server MCP Server
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft_sql_server_mcp)](https://pypi.org/project/microsoft_sql_server_mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<a href="https://glama.ai/mcp/servers/29cpe19k30">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/29cpe19k30/badge" alt="Microsoft SQL Server MCP server" />
+</a>
+
+A Model Context Protocol (MCP) server for secure SQL Server database access through Claude Desktop.
+
+## Features
+
+- 🔍 List database tables
+- 📊 Execute SQL queries (SELECT, INSERT, UPDATE, DELETE)
+- 🔐 Multiple authentication methods (SQL, Windows, Azure AD)
+- 🏢 LocalDB and Azure SQL support
+- 🔌 Custom port configuration
+
+## Quick Start
+
+### Install with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mssql": {
+      "command": "uvx",
+      "args": ["microsoft_sql_server_mcp"],
+      "env": {
+        "MSSQL_SERVER": "localhost",
+        "MSSQL_DATABASE": "your_database",
+        "MSSQL_USER": "your_username",
+        "MSSQL_PASSWORD": "your_password"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+### Basic SQL Authentication
+```bash
+MSSQL_SERVER=localhost          # Required
+MSSQL_DATABASE=your_database    # Required
+MSSQL_USER=your_username        # Required for SQL auth
+MSSQL_PASSWORD=your_password    # Required for SQL auth
+```
+
+### Windows Authentication
+```bash
+MSSQL_SERVER=localhost
+MSSQL_DATABASE=your_database
+MSSQL_WINDOWS_AUTH=true         # Use Windows credentials
+```
+
+### Azure SQL Database
+```bash
+MSSQL_SERVER=your-server.database.windows.net
+MSSQL_DATABASE=your_database
+MSSQL_USER=your_username
+MSSQL_PASSWORD=your_password
+# Encryption is automatic for Azure
+```
+
+### Optional Settings
+```bash
+MSSQL_PORT=1433                 # Custom port (default: 1433)
+MSSQL_ENCRYPT=true              # Force encryption
+```
+
+## Alternative Installation Methods
+
+### Using pip
+```bash
+pip install microsoft_sql_server_mcp
+```
+
+Then in `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "mssql": {
+      "command": "python",
+      "args": ["-m", "mssql_mcp_server"],
+      "env": { ... }
+    }
+  }
+}
+```
+
+### Development
+```bash
+git clone https://github.com/RichardHan/mssql_mcp_server.git
+cd mssql_mcp_server
+pip install -e .
+```
+
+## Security
+
+- Create a dedicated SQL user with minimal permissions
+- Never use admin/sa accounts
+- Use Windows Authentication when possible
+- Enable encryption for sensitive data
+
+## License
+
+MIT