{"id":50530817,"url":"https://github.com/chrismannina/sqlserver-mcp","last_synced_at":"2026-06-03T13:02:54.815Z","repository":{"id":331388937,"uuid":"1126436040","full_name":"chrismannina/sqlserver-mcp","owner":"chrismannina","description":"MCP server for Microsoft SQL Server — schema discovery, queries, and stored procedures via pyodbc","archived":false,"fork":false,"pushed_at":"2026-03-25T03:53:19.000Z","size":122,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-26T09:32:01.539Z","etag":null,"topics":["database","fastmcp","mcp","mssql","pyodbc","sqlserver"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chrismannina.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-01T22:56:00.000Z","updated_at":"2026-03-25T03:55:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chrismannina/sqlserver-mcp","commit_stats":null,"previous_names":["chrismannina/mssql-mcp","chrismannina/sqlserver-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chrismannina/sqlserver-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrismannina%2Fsqlserver-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrismannina%2Fsqlserver-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrismannina%2Fsqlserver-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrismannina%2Fsqlserver-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chrismannina","download_url":"https://codeload.github.com/chrismannina/sqlserver-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrismannina%2Fsqlserver-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33865655,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","fastmcp","mcp","mssql","pyodbc","sqlserver"],"created_at":"2026-06-03T13:02:53.639Z","updated_at":"2026-06-03T13:02:54.809Z","avatar_url":"https://github.com/chrismannina.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sqlserver-mcp\n\nMCP (Model Context Protocol) server for Microsoft SQL Server using pyodbc.\n\n## Features\n\n- 12 tools for database exploration and querying\n- Windows and SQL Server authentication\n- Connection pooling with health checks\n- Query timeout and row limits\n- Structured error handling\n\n## Installation\n\n### From GitHub\n\n```bash\nuv pip install git+https://github.com/chrismannina/sqlserver-mcp.git --system\n```\n\n### From source (for development)\n\n```bash\ngit clone git@github.com:chrismannina/sqlserver-mcp.git\ncd sqlserver-mcp\nuv pip install -e \".[dev]\" --system\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `MSSQL_SERVER` | Yes | - | SQL Server hostname or IP address |\n| `MSSQL_DATABASE` | Yes | - | Database name |\n| `MSSQL_WINDOWS_AUTH` | No | `false` | Set to `true` for Windows authentication |\n| `MSSQL_USER` | Conditional | - | Username (required if not using Windows auth) |\n| `MSSQL_PASSWORD` | Conditional | - | Password (required if not using Windows auth) |\n| `MSSQL_DRIVER` | No | auto | ODBC driver name (auto-detected if not set) |\n| `MSSQL_QUERY_TIMEOUT` | No | `30` | Query timeout in seconds |\n| `MSSQL_MAX_ROWS` | No | `1000` | Default max rows returned by queries |\n| `MSSQL_DEBUG` | No | `false` | Enable debug logging to stderr |\n\n### Connection Security\n\nAll connections use:\n- `Encrypt=yes` - Encrypted connections\n- `TrustServerCertificate=yes` - Trust the server certificate\n\n## Usage\n\n### With Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mssql\": {\n      \"command\": \"sqlserver-mcp\",\n      \"env\": {\n        \"MSSQL_SERVER\": \"your-server\",\n        \"MSSQL_DATABASE\": \"your-database\",\n        \"MSSQL_USER\": \"your-user\",\n        \"MSSQL_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### With Claude Code\n\nAdd to `~/.claude/settings.json` or project `.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mssql\": {\n      \"command\": \"sqlserver-mcp\",\n      \"env\": {\n        \"MSSQL_SERVER\": \"your-server\",\n        \"MSSQL_DATABASE\": \"your-database\",\n        \"MSSQL_USER\": \"your-user\",\n        \"MSSQL_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### With OpenCode\n\nAdd an `mcp` section to `opencode.json` or `~/.config/opencode/config.json`:\n\n```json\n{\n  \"mcp\": {\n    \"mydb\": {\n      \"type\": \"local\",\n      \"command\": [\"sqlserver-mcp\"],\n      \"enabled\": true,\n      \"environment\": {\n        \"MSSQL_SERVER\": \"your-server\",\n        \"MSSQL_DATABASE\": \"your-database\",\n        \"MSSQL_USER\": \"{env:MSSQL_USER}\",\n        \"MSSQL_PASSWORD\": \"{env:MSSQL_PASSWORD}\"\n      }\n    }\n  }\n}\n```\n\n### Running Directly\n\n```bash\nMSSQL_SERVER=your-server MSSQL_DATABASE=your-db MSSQL_USER=user MSSQL_PASSWORD=pass sqlserver-mcp\n```\n\n## Tools\n\n### Discovery\n- **list_schemas** - List all schemas\n- **list_tables** - List tables (optionally by schema, with row counts)\n- **list_views** - List views (optionally by schema)\n- **list_procedures** - List stored procedures\n\n### Description\n- **describe_table** - Table structure (columns, PKs, FKs, indexes)\n- **describe_procedure** - Procedure details (parameters, definition)\n\n### Search\n- **search_tables** - Find tables/views by pattern (`%` wildcards)\n- **search_columns** - Find columns across tables by pattern\n\n### Data\n- **get_table_sample** - Sample rows (max 100)\n- **get_table_stats** - Row count, space usage, dates\n- **query** - Execute SQL with parameterized queries and row limits\n- **execute_procedure** - Run stored procedures with parameters\n\n## Development\n\n```bash\nuv run --extra dev pytest -v\n```\n\n## Requirements\n\n- Python 3.10+\n- ODBC Driver for SQL Server (17 or 18 recommended)\n\n### Installing ODBC Driver\n\n**Linux (Ubuntu/Debian):**\n```bash\ncurl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -\ncurl https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list\nsudo apt-get update\nsudo ACCEPT_EULA=Y apt-get install -y msodbcsql18\n```\n\n**macOS:**\n```bash\nbrew install microsoft/mssql-release/msodbcsql18\n```\n\n**Windows:** Download from [Microsoft](https://learn.microsoft.com/en-us/sql/connect/odbc/download-odbc-driver-for-sql-server)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrismannina%2Fsqlserver-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchrismannina%2Fsqlserver-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrismannina%2Fsqlserver-mcp/lists"}