Metadata-Version: 2.4
Name: datasource-mcp
Version: 0.1.0
Summary: MySQL datasource MCP server for AI clients
Project-URL: Homepage, https://github.com/wangguoxi0814/datasource-mcp
Project-URL: Repository, https://github.com/wangguoxi0814/datasource-mcp
Project-URL: Issues, https://github.com/wangguoxi0814/datasource-mcp/issues
Author-email: Peter <wangguoxi52@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: database,fastmcp,mcp,model-context-protocol,mysql
Classifier: Development Status :: 3 - Alpha
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
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Database
Requires-Python: >=3.11
Requires-Dist: fastmcp>=3.4.2
Requires-Dist: mysql-connector-python>=9.7.0
Description-Content-Type: text/markdown

# datasource-mcp

MySQL datasource MCP server for AI clients (Cursor, Claude Desktop, etc.).

## Install

```bash
pip install datasource-mcp
# or
uvx datasource-mcp
```

## Cursor / MCP Client Config

```json
{
  "mcpServers": {
    "datasource-mcp": {
      "command": "datasource-mcp",
      "env": {
        "DB_HOST": "127.0.0.1",
        "DB_PORT": "3306",
        "DB_USER": "root",
        "DB_PASSWORD": "your_password",
        "DB_NAME": "your_database"
      }
    }
  }
}
```

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `DB_HOST` | `127.0.0.1` | MySQL host |
| `DB_PORT` | `3306` | MySQL port |
| `DB_USER` | `root` | MySQL user |
| `DB_PASSWORD` | `root` | MySQL password |
| `DB_NAME` | `aix` | Database name |
| `DB_CONNECT_TIMEOUT` | `5` | Connection timeout (seconds) |

## Tools

### `db_exe`

Execute SQL and return a JSON string:

```json
{"success": true, "row_count": 1, "truncated": false, "rows": [...]}
```

## Local Development

```bash
uv sync
uv run datasource-mcp
# or
uv run python -m datasource_mcp
```
