mcp-maker 0.1.0__tar.gz

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

@@ -0,0 +1,46 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write  # Required for PyPI Trusted Publisher
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run tests
+        run: pytest tests/ -v
+
+  publish:
+    name: Build & Publish to PyPI
+    needs: test
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mcp-maker
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # No API token needed — uses Trusted Publisher (OIDC)

mcp_maker-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,26 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v

mcp_maker-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.env
+*.db
+*.sqlite
+*.sqlite3
+mcp_server.py
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+*.log

mcp_maker-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ali Hasan
+
+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.

mcp_maker-0.1.0/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: mcp-maker
+Version: 0.1.0
+Summary: Auto-generate MCP servers from any data source. Zero code required.
+Project-URL: Homepage, https://github.com/MrAliHasan/mcp-maker
+Project-URL: Documentation, https://github.com/MrAliHasan/mcp-maker#readme
+Project-URL: Repository, https://github.com/MrAliHasan/mcp-maker
+Project-URL: Issues, https://github.com/MrAliHasan/mcp-maker/issues
+Author-email: Ali Hasan <ali@example.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,claude,generator,llm,mcp,model-context-protocol,server
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: airtable
+Requires-Dist: pyairtable>=2.0.0; extra == 'airtable'
+Provides-Extra: all
+Requires-Dist: psycopg2-binary>=2.9.0; extra == 'all'
+Requires-Dist: pyairtable>=2.0.0; extra == 'all'
+Requires-Dist: pymysql>=1.1.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Provides-Extra: mysql
+Requires-Dist: pymysql>=1.1.0; extra == 'mysql'
+Provides-Extra: postgres
+Requires-Dist: psycopg2-binary>=2.9.0; extra == 'postgres'
+Description-Content-Type: text/markdown
+
+# MCP-Maker
+
+### ⚒️ Auto-generate MCP servers from any data source. Zero code required.
+
+> Point MCP-Maker at a database, API, or file directory and get a fully functional [MCP](https://modelcontextprotocol.io/) server in seconds — ready for Claude, ChatGPT, Cursor, and any MCP-compatible AI.
+
+---
+
+## 🚀 Quick Start
+
+```bash
+pip install mcp-maker
+
+# From a SQLite database
+mcp-maker init sqlite:///my_database.db
+mcp-maker serve
+
+# From CSV/JSON files
+mcp-maker init ./data/
+mcp-maker serve
+
+# That's it! Your AI can now query your data.
+```
+
+## Why MCP-Maker?
+
+| | FastMCP | MCP-Maker |
+|---|---------|----------|
+| **Approach** | You write Python tools | It generates everything |
+| **Setup time** | Minutes–hours | Seconds |
+| **Code required** | Yes | No |
+| **Best for** | Custom logic | Data access |
+
+MCP-Maker uses FastMCP under the hood — it's not competing, it's building on top.
+
+---
+
+## 📋 Commands
+
+| Command | Description |
+|---------|-------------|
+| `mcp-maker init <source>` | Generate an MCP server from a data source |
+| `mcp-maker inspect <source>` | Preview what would be generated (dry run) |
+| `mcp-maker serve` | Run the generated MCP server |
+| `mcp-maker list-connectors` | Show available connectors |
+
+## 🔌 Connectors
+
+### Built-in
+
+| Connector | URI Format | Status |
+|-----------|-----------|--------|
+| **SQLite** | `sqlite:///path/to/db.sqlite` | ✅ Ready |
+| **Files** (CSV, JSON, txt) | `./path/to/directory/` | ✅ Ready |
+| **PostgreSQL** | `postgres://user:pass@host/db` | 🔜 Coming |
+| **MySQL** | `mysql://user:pass@host/db` | 🔜 Coming |
+| **Airtable** | `airtable://appXXXX` | 🔜 Coming |
+
+### Want to add a connector?
+
+Every connector is a single Python file — PRs welcome! See [Contributing](#contributing).
+
+---
+
+## 🛠️ What Gets Generated
+
+For each table in your data source, MCP-Maker generates:
+
+| Tool | Description |
+|------|-------------|
+| `list_{table}(limit, offset)` | Paginated listing |
+| `get_{table}_by_{pk}(id)` | Get by primary key |
+| `search_{table}(query)` | Full-text search |
+| `count_{table}()` | Row count |
+| `schema_{table}()` | Column names and types |
+
+For text files, it generates `read_{name}()` resources.
+
+---
+
+## 💡 Example: SQLite Database
+
+```bash
+$ mcp-maker init sqlite:///chinook.db
+
+⚒️  MCP-Maker v0.1.0
+
+✅ Connected to sqlite source
+
+┌──────────────────────────────────┐
+│ 📊 Discovered Tables (11)       │
+├──────────┬──────────┬────────────┤
+│ Table    │ Columns  │ Rows       │
+├──────────┼──────────┼────────────┤
+│ albums   │ id, ...  │ 347        │
+│ artists  │ id, ...  │ 275        │
+│ tracks   │ id, ...  │ 3503       │
+└──────────┴──────────┴────────────┘
+
+🎉 Generated: mcp_server.py
+
+$ mcp-maker serve
+🚀 MCP-Maker Server running...
+```
+
+Now in Claude Desktop, add the server and ask: *"What are the top 5 artists with the most albums?"*
+
+---
+
+## 🤝 Contributing
+
+MCP-Maker is designed for community contributions — each new **connector** is a self-contained PR:
+
+1. Create `src/mcp_maker/connectors/your_connector.py`
+2. Subclass `BaseConnector`
+3. Implement `validate()` and `inspect()`
+4. Register with `register_connector("scheme", YourConnector)`
+5. Add tests
+
+See `connectors/sqlite.py` as a reference implementation.
+
+---
+
+## 📦 Installation
+
+```bash
+# Core (SQLite + Files)
+pip install mcp-maker
+
+# With PostgreSQL support
+pip install mcp-maker[postgres]
+
+# With all connectors
+pip install mcp-maker[all]
+
+# Development
+pip install mcp-maker[dev]
+```
+
+## License
+
+MIT

mcp_maker-0.1.0/README.md

@@ -0,0 +1,142 @@
+# MCP-Maker
+
+### ⚒️ Auto-generate MCP servers from any data source. Zero code required.
+
+> Point MCP-Maker at a database, API, or file directory and get a fully functional [MCP](https://modelcontextprotocol.io/) server in seconds — ready for Claude, ChatGPT, Cursor, and any MCP-compatible AI.
+
+---
+
+## 🚀 Quick Start
+
+```bash
+pip install mcp-maker
+
+# From a SQLite database
+mcp-maker init sqlite:///my_database.db
+mcp-maker serve
+
+# From CSV/JSON files
+mcp-maker init ./data/
+mcp-maker serve
+
+# That's it! Your AI can now query your data.
+```
+
+## Why MCP-Maker?
+
+| | FastMCP | MCP-Maker |
+|---|---------|----------|
+| **Approach** | You write Python tools | It generates everything |
+| **Setup time** | Minutes–hours | Seconds |
+| **Code required** | Yes | No |
+| **Best for** | Custom logic | Data access |
+
+MCP-Maker uses FastMCP under the hood — it's not competing, it's building on top.
+
+---
+
+## 📋 Commands
+
+| Command | Description |
+|---------|-------------|
+| `mcp-maker init <source>` | Generate an MCP server from a data source |
+| `mcp-maker inspect <source>` | Preview what would be generated (dry run) |
+| `mcp-maker serve` | Run the generated MCP server |
+| `mcp-maker list-connectors` | Show available connectors |
+
+## 🔌 Connectors
+
+### Built-in
+
+| Connector | URI Format | Status |
+|-----------|-----------|--------|
+| **SQLite** | `sqlite:///path/to/db.sqlite` | ✅ Ready |
+| **Files** (CSV, JSON, txt) | `./path/to/directory/` | ✅ Ready |
+| **PostgreSQL** | `postgres://user:pass@host/db` | 🔜 Coming |
+| **MySQL** | `mysql://user:pass@host/db` | 🔜 Coming |
+| **Airtable** | `airtable://appXXXX` | 🔜 Coming |
+
+### Want to add a connector?
+
+Every connector is a single Python file — PRs welcome! See [Contributing](#contributing).
+
+---
+
+## 🛠️ What Gets Generated
+
+For each table in your data source, MCP-Maker generates:
+
+| Tool | Description |
+|------|-------------|
+| `list_{table}(limit, offset)` | Paginated listing |
+| `get_{table}_by_{pk}(id)` | Get by primary key |
+| `search_{table}(query)` | Full-text search |
+| `count_{table}()` | Row count |
+| `schema_{table}()` | Column names and types |
+
+For text files, it generates `read_{name}()` resources.
+
+---
+
+## 💡 Example: SQLite Database
+
+```bash
+$ mcp-maker init sqlite:///chinook.db
+
+⚒️  MCP-Maker v0.1.0
+
+✅ Connected to sqlite source
+
+┌──────────────────────────────────┐
+│ 📊 Discovered Tables (11)       │
+├──────────┬──────────┬────────────┤
+│ Table    │ Columns  │ Rows       │
+├──────────┼──────────┼────────────┤
+│ albums   │ id, ...  │ 347        │
+│ artists  │ id, ...  │ 275        │
+│ tracks   │ id, ...  │ 3503       │
+└──────────┴──────────┴────────────┘
+
+🎉 Generated: mcp_server.py
+
+$ mcp-maker serve
+🚀 MCP-Maker Server running...
+```
+
+Now in Claude Desktop, add the server and ask: *"What are the top 5 artists with the most albums?"*
+
+---
+
+## 🤝 Contributing
+
+MCP-Maker is designed for community contributions — each new **connector** is a self-contained PR:
+
+1. Create `src/mcp_maker/connectors/your_connector.py`
+2. Subclass `BaseConnector`
+3. Implement `validate()` and `inspect()`
+4. Register with `register_connector("scheme", YourConnector)`
+5. Add tests
+
+See `connectors/sqlite.py` as a reference implementation.
+
+---
+
+## 📦 Installation
+
+```bash
+# Core (SQLite + Files)
+pip install mcp-maker
+
+# With PostgreSQL support
+pip install mcp-maker[postgres]
+
+# With all connectors
+pip install mcp-maker[all]
+
+# Development
+pip install mcp-maker[dev]
+```
+
+## License
+
+MIT

mcp_maker-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcp-maker"
+version = "0.1.0"
+description = "Auto-generate MCP servers from any data source. Zero code required."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Ali Hasan", email = "ali@example.com" },
+]
+keywords = ["mcp", "model-context-protocol", "ai", "llm", "claude", "server", "generator"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "jinja2>=3.1.0",
+    "mcp>=1.0.0",
+]
+
+[project.optional-dependencies]
+postgres = ["psycopg2-binary>=2.9.0"]
+mysql = ["pymysql>=1.1.0"]
+airtable = ["pyairtable>=2.0.0"]
+all = ["mcp-maker[postgres,mysql,airtable]"]
+dev = ["pytest>=8.0.0", "pytest-asyncio>=0.23.0"]
+
+[project.scripts]
+mcp-maker = "mcp_maker.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/MrAliHasan/mcp-maker"
+Documentation = "https://github.com/MrAliHasan/mcp-maker#readme"
+Repository = "https://github.com/MrAliHasan/mcp-maker"
+Issues = "https://github.com/MrAliHasan/mcp-maker/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_maker"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

mcp_maker-0.1.0/src/mcp_maker/__init__.py

@@ -0,0 +1,8 @@
+"""
+MCP-Maker — Auto-generate MCP servers from any data source.
+
+Point MCP-Maker at a database, API, or file directory and get a
+fully functional MCP server — zero Python code required.
+"""
+
+__version__ = "0.1.0"