@neverinfamous/mysql-mcp 2.1.0

package/DOCKER_README.md

@@ -0,0 +1,482 @@
+# MySQL MCP Server
+
+*Last updated January 3, 2026 - Production/Stable v2.1.0*
+
+[![GitHub](https://img.shields.io/badge/GitHub-neverinfamous/mysql--mcp-blue?logo=github)](https://github.com/neverinfamous/mysql-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CodeQL](https://github.com/neverinfamous/mysql-mcp/actions/workflows/codeql.yml/badge.svg)](https://github.com/neverinfamous/mysql-mcp/actions/workflows/codeql.yml)
+![Version](https://img.shields.io/badge/version-2.1.0-green)
+![Status](https://img.shields.io/badge/status-Production%2FStable-brightgreen)
+[![Docker Pulls](https://img.shields.io/docker/pulls/writenotenow/mysql-mcp)](https://hub.docker.com/r/writenotenow/mysql-mcp)
+[![Security](https://img.shields.io/badge/Security-Enhanced-green.svg)](SECURITY.md)
+![TypeScript](https://img.shields.io/badge/TypeScript-Strict-blue.svg)
+![Tests](https://img.shields.io/badge/Tests-1590%20passing-brightgreen.svg)
+![Coverage](https://img.shields.io/badge/Coverage-97%25-green.svg)
+
+**[📚 Full Documentation (Wiki)](https://github.com/neverinfamous/mysql-mcp/wiki)** • **[Changelog](https://github.com/neverinfamous/mysql-mcp/blob/master/CHANGELOG.md)** • **[Security](https://github.com/neverinfamous/mysql-mcp/blob/master/SECURITY.md)**
+
+## The Most Comprehensive MySQL MCP Server Available
+
+**mysql-mcp** is the definitive **Model Context Protocol server for MySQL** — empowering AI assistants like AntiGravity, Claude, Cursor, and other MCP clients with **unparalleled database capabilities**. Built for developers who demand enterprise-grade features without sacrificing ease of use.
+
+### 🎯 What Sets Us Apart
+
+| Feature | Description |
+|---------|-------------|
+| **191 Specialized Tools** | The largest MySQL tool collection for MCP — from core CRUD and native JSON functions (MySQL 5.7+) to advanced spatial/GIS, document store, and cluster management |
+| **18 Observability Resources** | Real-time schema, performance metrics, process lists, status variables, replication status, and InnoDB diagnostics |
+| **19 AI-Powered Prompts** | Guided workflows for query building, schema design, performance tuning, and infrastructure setup |
+| **OAuth 2.1 + Access Control** | Enterprise-ready security with RFC 9728/8414 compliance, granular scopes (`read`, `write`, `admin`, `full`, `db:*`, `table:*:*`), and Keycloak integration |
+| **Smart Tool Filtering** | 24 tool groups + 7 meta-groups let you stay within IDE limits while exposing exactly what you need |
+| **HTTP Streaming Transport** | SSE-based streaming with `/sse`, `/messages`, and `/health` endpoints for remote deployments |
+| **High-Performance Pooling** | Built-in connection pooling for efficient, concurrent database access |
+| **Ecosystem Integrations** | First-class support for **MySQL Router**, **ProxySQL**, and **MySQL Shell** utilities |
+| **Advanced Encryption** | Full TLS/SSL support for secure connections, plus tools for managing data masking, encryption monitoring, and compliance |
+| **Production-Ready Security** | SQL injection protection, parameterized queries, input validation, and audit capabilities |
+| **Strict TypeScript** | 100% type-safe codebase with 1550+ tests and 97% coverage |
+| **MCP 2025-11-25 Compliant** | Full protocol support with tool safety hints, resource priorities, and progress notifications |
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Node.js 18+
+- MySQL 5.7+ or 8.0+ server
+- npm or yarn
+
+### Installation
+
+```bash
+git clone https://github.com/neverinfamous/mysql-mcp.git
+cd mysql-mcp
+npm install
+npm run build
+node dist/cli.js --transport stdio --mysql mysql://user:password@localhost:3306/database
+```
+
+### Docker
+
+```bash
+docker run -i --rm writenotenow/mysql-mcp:latest \
+  --transport stdio \
+  --mysql mysql://user:password@host.docker.internal:3306/database
+```
+
+---
+
+## ⚡ MCP Client Configuration
+
+### HTTP/SSE Server Usage (Advanced)
+
+> **When to use HTTP mode:** Use HTTP mode when deploying `mysql-mcp` as a standalone server that multiple clients can connect to remotely. For local development with Claude Desktop or Cursor IDE, use the default `stdio` mode shown below instead.
+
+**Use cases for HTTP mode:**
+- Running the server in a Docker container accessible over a network
+- Deploying to cloud platforms (AWS, GCP, Azure)
+- Enabling OAuth 2.1 authentication for enterprise security
+- Allowing multiple AI clients to share one database connection
+
+## OAuth 2.1 Authentication
+
+For enterprise deployments, mysql-mcp supports OAuth 2.1 authentication with Keycloak or any RFC-compliant provider.
+
+### Quick Setup
+
+**1. Start with OAuth disabled (default)**
+```bash
+mysql-mcp --mysql mysql://root:pass@localhost/db
+```
+
+**2. Enable OAuth with an identity provider**
+```bash
+mysql-mcp --mysql mysql://root:pass@localhost/db \
+          --oauth-enabled \
+          --oauth-issuer http://localhost:8080/realms/mysql-mcp \
+          --oauth-audience mysql-mcp
+```
+
+**Start the HTTP server:**
+
+```bash
+# Local installation
+node dist/cli.js --transport http --port 3000 --mysql mysql://user:password@localhost:3306/database
+
+# Docker (expose port 3000)
+docker run -p 3000:3000 writenotenow/mysql-mcp \
+  --transport http \
+  --port 3000 \
+  --mysql mysql://user:password@host.docker.internal:3306/database
+```
+
+**Available endpoints:**
+- `GET /sse` - Establish MCP connection via Server-Sent Events
+- `POST /messages` - Send JSON-RPC messages to the server
+- `GET /health` - Health check endpoint
+- `GET /.well-known/oauth-protected-resource` - OAuth 2.1 metadata (when OAuth enabled)
+
+> **💡 Tip:** Most users should skip this section and use the stdio configuration below for local AI IDE integration.
+
+### Cursor IDE / Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "mysql-mcp": {
+      "command": "node",
+      "args": [
+        "C:/path/to/mysql-mcp/dist/cli.js",
+        "--transport", "stdio",
+        "--mysql", "mysql://user:password@localhost:3306/database"
+      ]
+    }
+  }
+}
+```
+
+### Using Environment Variables (Recommended)
+
+```json
+{
+  "mcpServers": {
+    "mysql-mcp": {
+      "command": "node",
+      "args": [
+        "C:/path/to/mysql-mcp/dist/cli.js",
+        "--transport", "stdio"
+      ],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "your_user",
+        "MYSQL_PASSWORD": "your_password",
+        "MYSQL_DATABASE": "your_database"
+      }
+    }
+  }
+}
+```
+
+> **📖 See the [Configuration Wiki](https://github.com/neverinfamous/mysql-mcp/wiki/Configuration)** for more configuration options.
+
+---
+
+## 🔗 Database Connection Scenarios
+
+| Scenario | Host to Use | Example Connection String |
+|----------|-------------|---------------------------|
+| **MySQL on host machine** | `host.docker.internal` | `mysql://user:pass@host.docker.internal:3306/db` |
+| **MySQL in Docker** | Container name or network | `mysql://user:pass@mysql-container:3306/db` |
+| **Remote/Cloud MySQL** | Hostname or IP | `mysql://user:pass@db.example.com:3306/db` |
+
+### MySQL on Host Machine
+If MySQL is installed directly on your computer (via installer, Homebrew, etc.):
+```json
+"--mysql", "mysql://user:password@host.docker.internal:3306/database"
+```
+
+### MySQL in Another Docker Container
+Add both containers to the same Docker network, then use the container name:
+```bash
+# Create network and run MySQL
+docker network create mynet
+docker run -d --name mysql-db --network mynet -e MYSQL_ROOT_PASSWORD=pass mysql:8
+# Run MCP server on same network
+docker run -i --rm --network mynet writenotenow/mysql-mcp:latest \
+  --transport stdio --mysql mysql://root:pass@mysql-db:3306/mysql
+```
+
+### Remote/Cloud MySQL (RDS, Cloud SQL, etc.)
+Use the remote hostname directly:
+```json
+"--mysql", "mysql://user:password@your-instance.region.rds.amazonaws.com:3306/database"
+```
+
+| Provider | Example Hostname |
+|----------|------------------|
+| AWS RDS | `your-instance.xxxx.us-east-1.rds.amazonaws.com` |
+| Google Cloud SQL | `project:region:instance` (via Cloud SQL Proxy) |
+| Azure MySQL | `your-server.mysql.database.azure.com` |
+| PlanetScale | `aws.connect.psdb.cloud` (SSL required) |
+| DigitalOcean | `your-cluster-do-user-xxx.db.ondigitalocean.com` |
+
+> **Tip:** For remote connections, ensure your MySQL server allows connections from Docker's IP range and that firewalls/security groups permit port 3306.
+
+---
+
+## 🛠️ Tool Filtering
+
+> [!IMPORTANT]
+> **AI IDEs like Cursor have tool limits (typically 40-50 tools).** With 191 tools available, you MUST use tool filtering to stay within your IDE's limits. We recommend `starter` (38 tools) as a starting point.
+
+### What Can You Filter?
+
+The `--tool-filter` argument accepts **shortcuts**, **groups**, or **tool names** — mix and match freely:
+
+| Filter Pattern | Example | Tools | Description |
+|----------------|---------|-------|-------------|
+| Shortcut only | `starter` | 38 | Use a predefined bundle |
+| Groups only | `core,json,transactions` | 32 | Combine individual groups |
+| Shortcut + Group | `starter,spatial` | 50 | Extend a shortcut |
+| Shortcut - Tool | `starter,-mysql_drop_table` | 37 | Remove specific tools |
+
+### Shortcuts (Predefined Bundles)
+
+| Shortcut | Tools | Use Case | What's Included |
+|----------|-------|----------|-----------------|
+| `starter` | **38** | 🌟 **Recommended** | Core, JSON, trans, text |
+| `essential` | 15 | Minimal footprint | Core, trans |
+| `dev-power` | 45 | Power Developer | Core, schema, perf, stats, fulltext, trans |
+| `ai-data` | 44 | AI Data Analyst | Core, JSON, docstore, text, fulltext |
+| `ai-spatial` | 43 | AI Spatial Analyst | Core, spatial, stats, perf, trans |
+| `dba-monitor` | 35 | DBA Monitoring | Core, monitor, perf, sysschema, opt |
+| `dba-manage` | 33 | DBA Management | Core, admin, backup, repl, parts, events |
+| `dba-secure` | 42 | DBA Security | Core, security, roles, cluster, trans |
+| `base-core` | 48 | Base Ops | Core, JSON, trans, text, schema |
+| `base-advanced` | 39 | Advanced Features | DocStore, spatial, stats, fulltext, events |
+| `ecosystem` | 31 | External Tools | Router, ProxySQL, Shell |
+
+### Tool Groups (24 Available)
+
+| Group | Tools | Description |
+|-------|-------|-------------|
+| `core` | 8 | Read/write queries, tables, indexes |
+| `transactions` | 7 | BEGIN, COMMIT, ROLLBACK, savepoints |
+| `json` | 17 | JSON functions, merge, diff, stats |
+| `text` | 6 | REGEXP, LIKE, SOUNDEX |
+| `fulltext` | 4 | Natural language search |
+| `performance` | 8 | EXPLAIN, query analysis, slow queries |
+| `optimization` | 4 | Index hints, recommendations |
+| `admin` | 6 | OPTIMIZE, ANALYZE, CHECK |
+| `monitoring` | 7 | PROCESSLIST, status variables |
+| `backup` | 4 | Export, import, mysqldump |
+| `replication` | 5 | Master/slave, binlog |
+| `partitioning` | 4 | Partition management |
+| `router` | 9 | MySQL Router REST API |
+| `proxysql` | 12 | ProxySQL management |
+| `shell` | 10 | MySQL Shell utilities |
+| `schema` | 10 | Views, procedures, triggers, constraints |
+| `events` | 6 | Event Scheduler management |
+| `sysschema` | 8 | sys schema diagnostics |
+| `stats` | 8 | Statistical analysis tools |
+| `spatial` | 12 | Spatial/GIS operations |
+| `security` | 9 | Audit, SSL, encryption, masking |
+| `cluster` | 10 | Group Replication, InnoDB Cluster |
+| `roles` | 8 | MySQL 8.0 role management |
+| `docstore` | 9 | Document Store collections |
+
+---
+
+### Quick Start: Recommended IDE Configuration
+
+Add one of these configurations to your IDE's MCP settings file (e.g., `cline_mcp_settings.json`, `.cursorrules`, or equivalent):
+
+#### Option 1: Starter (38 Essential Tools)
+**Best for:** General MySQL database work - CRUD operations, schema management, and monitoring.
+
+```json
+{
+  "mcpServers": {
+    "mysql-mcp": {
+      "command": "node",
+      "args": [
+        "/path/to/mysql-mcp/dist/cli.js",
+        "--transport",
+        "stdio",
+        "--tool-filter",
+        "starter"
+      ],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "your_username",
+        "MYSQL_PASSWORD": "your_password",
+        "MYSQL_DATABASE": "your_database"
+      }
+    }
+  }
+}
+```
+
+#### Option 2: Ecosystem (31 Tools for InnoDB Cluster Deployments)
+**Best for:** MySQL Router, ProxySQL, MySQL Shell, and InnoDB Cluster deployments.
+
+> **⚠️ Prerequisites:** 
+> - **InnoDB Cluster** with MySQL Router requires the cluster to be running for Router REST API authentication (uses `metadata_cache` backend)
+> - Router REST API uses HTTPS with self-signed certificates by default — set `MYSQL_ROUTER_INSECURE=true` to bypass certificate verification
+> - See [MySQL Ecosystem Setup Guide](https://github.com/neverinfamous/mysql-mcp/wiki/MySQL-Ecosystem-Setup) for detailed instructions
+
+```json
+{
+  "mcpServers": {
+    "mysql-mcp-ecosystem": {
+      "command": "node",
+      "args": [
+        "/path/to/mysql-mcp/dist/cli.js",
+        "--transport",
+        "stdio",
+        "--tool-filter",
+        "ecosystem"
+      ],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3307",
+        "MYSQL_USER": "cluster_admin",
+        "MYSQL_PASSWORD": "cluster_password",
+        "MYSQL_DATABASE": "mysql",
+        "MYSQL_ROUTER_URL": "https://localhost:8443",
+        "MYSQL_ROUTER_USER": "rest_api",
+        "MYSQL_ROUTER_PASSWORD": "router_password",
+        "MYSQL_ROUTER_INSECURE": "true",
+        "PROXYSQL_HOST": "localhost",
+        "PROXYSQL_PORT": "6032",
+        "PROXYSQL_USER": "radmin",
+        "PROXYSQL_PASSWORD": "radmin",
+        "MYSQLSH_PATH": "/usr/local/bin/mysqlsh"
+      }
+    }
+  }
+}
+```
+
+**Customization Notes:**
+
+- Replace `/path/to/mysql-mcp/` with your actual installation path
+- Update credentials with your actual values
+- For Windows: Use forward slashes (e.g., `C:/mysql-mcp/dist/cli.js`) or escape backslashes
+- For Windows MySQL Shell: `"MYSQLSH_PATH": "C:\\Program Files\\MySQL\\MySQL Shell 9.5\\bin\\mysqlsh.exe"`
+- **Router Authentication:** Router REST API authenticates against the InnoDB Cluster metadata. The cluster must be running for authentication to work.
+- **Cluster Resource:** The `mysql://cluster` resource is only available when connected to an InnoDB Cluster node
+
+> **📖 See the [Tool Filtering Wiki](https://github.com/neverinfamous/mysql-mcp/wiki/Tool-Filtering)** for advanced examples.
+
+---
+
+## 💡 Usage Instructions
+
+> [!NOTE]
+> Usage instructions are **automatically provided** to AI agents via the MCP protocol during server initialization.
+
+For debugging or manual reference, see the source: [`src/constants/ServerInstructions.ts`](src/constants/ServerInstructions.ts)
+
+---
+
+## 🤖 AI-Powered Prompts
+
+This server includes **19 intelligent prompts** for guided workflows:
+
+| Prompt | Description |
+|--------|-------------|
+| `mysql_query_builder` | Construct SQL queries with security best practices |
+| `mysql_schema_design` | Design table schemas with indexes and relationships |
+| `mysql_performance_analysis` | Analyze slow queries with optimization recommendations |
+| `mysql_migration` | Generate migration scripts with rollback options |
+| `mysql_database_health_check` | Comprehensive database health assessment |
+| `mysql_backup_strategy` | Enterprise backup planning with RTO/RPO |
+| `mysql_index_tuning` | Index analysis and optimization workflow |
+| `mysql_setup_router` | MySQL Router configuration guide |
+| `mysql_setup_proxysql` | ProxySQL configuration guide |
+| `mysql_setup_replication` | Replication setup guide |
+| `mysql_setup_shell` | MySQL Shell usage guide |
+| `mysql_tool_index` | Complete tool index with categories |
+| `mysql_quick_query` | Quick query execution shortcut |
+| `mysql_quick_schema` | Quick schema exploration |
+| **`mysql_setup_events`** | Event Scheduler setup guide |
+| **`mysql_sys_schema_guide`** | sys schema usage and diagnostics |
+| **`mysql_setup_spatial`** | Spatial/GIS data setup guide |
+| **`mysql_setup_cluster`** | InnoDB Cluster/Group Replication guide |
+| **`mysql_setup_docstore`** | Document Store / X DevAPI guide |
+
+---
+
+## 📊 Resources
+
+This server exposes **18 resources** for database observability:
+
+| Resource | Description |
+|----------|-------------|
+| `mysql://schema` | Full database schema |
+| `mysql://tables` | Table listing with metadata |
+| `mysql://variables` | Server configuration variables |
+| `mysql://status` | Server status metrics |
+| `mysql://processlist` | Active connections and queries |
+| `mysql://pool` | Connection pool statistics |
+| `mysql://capabilities` | Server version, features, tool categories |
+| `mysql://health` | Comprehensive health status |
+| `mysql://performance` | Query performance metrics |
+| `mysql://indexes` | Index usage and statistics |
+| `mysql://replication` | Replication status and lag |
+| `mysql://innodb` | InnoDB buffer pool and engine metrics |
+| **`mysql://events`** | Event Scheduler status and scheduled events |
+| **`mysql://sysschema`** | sys schema diagnostics summary |
+| **`mysql://locks`** | InnoDB lock contention detection |
+| **`mysql://cluster`** | Group Replication/InnoDB Cluster status |
+| **`mysql://spatial`** | Spatial columns and indexes |
+| **`mysql://docstore`** | Document Store collections |
+
+---
+
+## 🔧 Advanced Configuration
+
+For specialized setups, see these Wiki pages:
+
+| Topic | Description |
+|-------|-------------|
+| [MySQL Router](https://github.com/neverinfamous/mysql-mcp/wiki/MySQL-Router) | Configure Router REST API access for InnoDB Cluster |
+| [ProxySQL](https://github.com/neverinfamous/mysql-mcp/wiki/ProxySQL) | Configure ProxySQL admin interface access |
+| [MySQL Shell](https://github.com/neverinfamous/mysql-mcp/wiki/MySQL-Shell) | Configure MySQL Shell for dump/load operations |
+
+---
+
+## ⚡ Performance Tuning
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `METADATA_CACHE_TTL_MS` | `30000` | Cache TTL for schema metadata (milliseconds) |
+| `LOG_LEVEL` | `info` | Log verbosity: `debug`, `info`, `warning`, `error` |
+
+> **Tip:** Lower `METADATA_CACHE_TTL_MS` for development (e.g., `5000`), or increase it for production with stable schemas (e.g., `300000` = 5 min).
+
+---
+
+### CLI Options
+
+| Option | Environment Variable | Description |
+|--------|---------------------|-------------|
+| `--oauth-enabled` | `OAUTH_ENABLED` | Enable OAuth authentication |
+| `--oauth-issuer` | `OAUTH_ISSUER` | Authorization server URL |
+| `--oauth-audience` | `OAUTH_AUDIENCE` | Expected token audience |
+| `--oauth-jwks-uri` | `OAUTH_JWKS_URI` | JWKS URI (auto-discovered) |
+| `--oauth-clock-tolerance` | `OAUTH_CLOCK_TOLERANCE` | Clock tolerance in seconds |
+
+### Scopes
+
+| Scope | Access Level |
+|-------|-------------|
+| `read` | Read-only queries |
+| `write` | Read + write operations |
+| `admin` | Administrative operations |
+| `full` | All operations |
+
+> **📖 See the [OAuth Wiki](https://github.com/neverinfamous/mysql-mcp/wiki/OAuth)** for Keycloak setup and detailed configuration.
+
+---
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) before submitting a pull request.
+
+## Security
+
+For security concerns, please see our [Security Policy](SECURITY.md).
+
+> **⚠️ Never commit credentials** - Store secrets in `.env` (gitignored)
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Code of Conduct
+
+Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before participating in this project.

package/Dockerfile

@@ -0,0 +1,78 @@
+# =============================================================================
+# MySQL MCP Server - Docker Image
+# =============================================================================
+# Multi-stage build for optimal image size and security
+# Production-ready image: ~150MB
+# =============================================================================
+
+# -----------------
+# Stage 1: Builder
+# -----------------
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# Install build dependencies
+RUN apk add --no-cache \
+    python3 \
+    make \
+    g++
+
+# Copy package files
+COPY package*.json ./
+
+# Install ALL dependencies (including devDependencies for build)
+RUN npm ci --include=dev
+
+# Copy source code
+COPY tsconfig.json ./
+COPY src/ ./src/
+
+# Build the application
+RUN npm run build
+
+# -----------------
+# Stage 2: Runtime
+# -----------------
+FROM node:20-alpine AS runtime
+
+# MCP Registry label for package validation
+LABEL io.modelcontextprotocol.server.name="io.github.neverinfamous/mysql-mcp"
+
+WORKDIR /app
+
+# Upgrade Alpine base packages to fix CVEs
+RUN apk upgrade --no-cache
+
+# Upgrade npm to fix CVEs in bundled dependencies:
+# - CVE-2024-21538: cross-spawn < 7.0.5
+# - CVE-2025-64756: glob < 10.5.0
+# - CVE-2025-5889: brace-expansion <= 2.0.1
+RUN npm install -g npm@latest && \
+    npm cache clean --force
+
+# Create non-root user for security
+RUN addgroup -g 1001 app && \
+    adduser -D -u 1001 -G app app
+
+# Copy package files
+COPY package*.json ./
+
+# Install production dependencies only
+RUN npm ci --omit=dev && \
+    npm cache clean --force
+
+# Copy built application from builder
+COPY --from=builder /app/dist ./dist
+
+# Set ownership to non-root user
+RUN chown -R app:app /app
+
+# Switch to non-root user
+USER app
+
+# Default entrypoint - run the CLI
+ENTRYPOINT ["node", "dist/cli.js"]
+
+# Default arguments (can be overridden)
+CMD ["--help"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Adamic.tech
+
+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 this 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.