mcp-creator-python 1.0.0__tar.gz

mcp_creator_python-1.0.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.env
+*.so
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/

mcp_creator_python-1.0.0/LAUNCHGUIDE.md

@@ -0,0 +1,46 @@
+# mcp-creator
+
+## Tagline
+Create, build, and publish Python MCP servers to PyPI — conversationally.
+
+## Description
+MCP Creator is a meta-tool that helps anyone create their own MCP servers. Install it, add it to your AI assistant, and the assistant walks you through the entire process: naming your package, checking PyPI availability, scaffolding a complete project with FastMCP, building, publishing, and pushing to GitHub. It remembers your setup across sessions so returning creators skip straight to building. Zero configuration required — just describe what you want to build and it handles the rest. Perfect for beginners who want to create and share their own MCP tools.
+
+## Setup Requirements
+No environment variables required. Just install and add to your MCP config.
+
+## Category
+Developer Tools
+
+## Features
+- Persistent creator profile — remembers your setup, usernames, and project history across sessions
+- Detects installed tools (uv, git, gh, PyPI token) and only walks through what's missing
+- Check PyPI package name availability before you start
+- Scaffold a complete, runnable MCP server project from a description and tool definitions
+- Generated projects use FastMCP, hatchling, and follow Python packaging best practices
+- Add new tools to existing projects without manual wiring
+- Build and publish to PyPI directly from your AI assistant
+- Initialize git, create a GitHub repo, and push code in one step
+- Generate LAUNCHGUIDE.md for MCP Marketplace submission
+- Zero external dependencies beyond mcp[cli] — installs instantly
+
+## Getting Started
+- "Create an MCP server that translates text between languages"
+- "I want to build an MCP that checks domain name availability"
+- "Help me make an MCP server for managing my Notion pages"
+- Tool: get_creator_profile — Load your profile and project history
+- Tool: update_creator_profile — Save setup state and project history across sessions
+- Tool: check_setup — Detect what's installed and skip setup you've already done
+- Tool: check_pypi_name — Verify your package name is available on PyPI
+- Tool: scaffold_server — Generate a complete project from tool definitions
+- Tool: add_tool — Add new tools to an existing project
+- Tool: build_package — Build with uv
+- Tool: publish_package — Publish to PyPI
+- Tool: setup_github — Create a GitHub repo and push your code
+- Tool: generate_launchguide — Create marketplace submission file
+
+## Tags
+mcp, developer-tools, scaffolding, python, pypi, code-generation, fastmcp, github, publishing
+
+## Documentation URL
+https://github.com/gmoneyn/mcp-creator

mcp_creator_python-1.0.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: mcp-creator-python
+Version: 1.0.0
+Summary: Create, build, and publish Python MCP servers to PyPI — conversationally
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: mcp[cli]>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# mcp-creator
+
+Create, build, and publish Python MCP servers to PyPI — conversationally.
+
+Install `mcp-creator`, add it to your AI assistant, and it walks you through the entire process: naming your package, scaffolding a complete project, building, and publishing to PyPI.
+
+## Install
+
+```bash
+pip install mcp-creator
+```
+
+## Setup
+
+Add to Claude Code (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "mcp-creator": {
+      "command": "mcp-creator",
+      "args": []
+    }
+  }
+}
+```
+
+Or for Cursor (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "mcp-creator": {
+      "command": "mcp-creator",
+      "args": []
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+|------|-------------|
+| `get_creator_profile` | Load your persistent profile — setup status, project history. Called first every session. |
+| `update_creator_profile` | Save setup state, usernames, and project history across sessions |
+| `check_setup` | Detect what's installed (uv, git, gh, PyPI token) — only walks through missing steps |
+| `check_pypi_name` | Check if a package name is available on PyPI |
+| `scaffold_server` | Create a complete MCP server project from a name + description + tool definitions |
+| `add_tool` | Add a new tool to an existing scaffolded project |
+| `build_package` | Run `uv build` on the project |
+| `publish_package` | Run `uv publish` to PyPI |
+| `setup_github` | Initialize git, create a GitHub repo, and push the code |
+| `generate_launchguide` | Create LAUNCHGUIDE.md for marketplace submission |
+
+## How It Works
+
+1. **Tell your AI what you want to build**: "I want an MCP server that checks the weather"
+2. **It checks the name**: calls `check_pypi_name` to verify availability on PyPI
+3. **It scaffolds the project**: calls `scaffold_server` with your tool definitions — generates a complete, runnable project
+4. **You fill in the logic**: replace the TODO stubs in `services/` with your real API calls
+5. **Build & publish**: `build_package` → `publish_package` → live on PyPI
+6. **Push to GitHub**: `setup_github` creates a repo and pushes your code
+7. **Submit to marketplace**: `generate_launchguide` creates the submission file with your repo URL
+
+## What Gets Generated
+
+For a project named `my-weather-mcp` with a `get_weather` tool:
+
+```
+my-weather-mcp/
+├── pyproject.toml         ← hatchling build, mcp[cli] dep, CLI entry point
+├── README.md              ← install instructions + MCP config JSON
+├── .gitignore
+├── src/my_weather_mcp/
+│   ├── __init__.py
+│   ├── server.py          ← FastMCP + @mcp.tool() for each tool
+│   ├── transport.py
+│   ├── tools/
+│   │   ├── __init__.py
+│   │   └── get_weather.py
+│   └── services/
+│       ├── __init__.py
+│       └── get_weather_service.py  ← TODO: your logic here
+└── tests/
+    ├── test_server.py
+    └── test_get_weather.py
+```
+
+The generated server runs immediately — stub services return placeholder data so you can test before implementing real logic.
+
+## Requirements
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/) (for building and publishing)
+
+## Development
+
+```bash
+git clone https://github.com/gmoneyn/mcp-creator.git
+cd mcp-creator
+uv venv .venv && source .venv/bin/activate
+uv pip install -e ".[dev]"
+pytest -v
+```

mcp_creator_python-1.0.0/README.md

@@ -0,0 +1,105 @@
+# mcp-creator
+
+Create, build, and publish Python MCP servers to PyPI — conversationally.
+
+Install `mcp-creator`, add it to your AI assistant, and it walks you through the entire process: naming your package, scaffolding a complete project, building, and publishing to PyPI.
+
+## Install
+
+```bash
+pip install mcp-creator
+```
+
+## Setup
+
+Add to Claude Code (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "mcp-creator": {
+      "command": "mcp-creator",
+      "args": []
+    }
+  }
+}
+```
+
+Or for Cursor (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "mcp-creator": {
+      "command": "mcp-creator",
+      "args": []
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+|------|-------------|
+| `get_creator_profile` | Load your persistent profile — setup status, project history. Called first every session. |
+| `update_creator_profile` | Save setup state, usernames, and project history across sessions |
+| `check_setup` | Detect what's installed (uv, git, gh, PyPI token) — only walks through missing steps |
+| `check_pypi_name` | Check if a package name is available on PyPI |
+| `scaffold_server` | Create a complete MCP server project from a name + description + tool definitions |
+| `add_tool` | Add a new tool to an existing scaffolded project |
+| `build_package` | Run `uv build` on the project |
+| `publish_package` | Run `uv publish` to PyPI |
+| `setup_github` | Initialize git, create a GitHub repo, and push the code |
+| `generate_launchguide` | Create LAUNCHGUIDE.md for marketplace submission |
+
+## How It Works
+
+1. **Tell your AI what you want to build**: "I want an MCP server that checks the weather"
+2. **It checks the name**: calls `check_pypi_name` to verify availability on PyPI
+3. **It scaffolds the project**: calls `scaffold_server` with your tool definitions — generates a complete, runnable project
+4. **You fill in the logic**: replace the TODO stubs in `services/` with your real API calls
+5. **Build & publish**: `build_package` → `publish_package` → live on PyPI
+6. **Push to GitHub**: `setup_github` creates a repo and pushes your code
+7. **Submit to marketplace**: `generate_launchguide` creates the submission file with your repo URL
+
+## What Gets Generated
+
+For a project named `my-weather-mcp` with a `get_weather` tool:
+
+```
+my-weather-mcp/
+├── pyproject.toml         ← hatchling build, mcp[cli] dep, CLI entry point
+├── README.md              ← install instructions + MCP config JSON
+├── .gitignore
+├── src/my_weather_mcp/
+│   ├── __init__.py
+│   ├── server.py          ← FastMCP + @mcp.tool() for each tool
+│   ├── transport.py
+│   ├── tools/
+│   │   ├── __init__.py
+│   │   └── get_weather.py
+│   └── services/
+│       ├── __init__.py
+│       └── get_weather_service.py  ← TODO: your logic here
+└── tests/
+    ├── test_server.py
+    └── test_get_weather.py
+```
+
+The generated server runs immediately — stub services return placeholder data so you can test before implementing real logic.
+
+## Requirements
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/) (for building and publishing)
+
+## Development
+
+```bash
+git clone https://github.com/gmoneyn/mcp-creator.git
+cd mcp-creator
+uv venv .venv && source .venv/bin/activate
+uv pip install -e ".[dev]"
+pytest -v
+```

mcp_creator_python-1.0.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "mcp-creator-python"
+version = "1.0.0"
+description = "Create, build, and publish Python MCP servers to PyPI — conversationally"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+dependencies = [
+    "mcp[cli]>=1.0.0",
+]
+
+[project.scripts]
+mcp-creator-python = "mcp_creator.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_creator"]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+]

mcp_creator_python-1.0.0/src/mcp_creator/__init__.py

@@ -0,0 +1 @@
+"""MCP Creator — create, build, and publish Python MCP servers to PyPI."""

mcp_creator_python-1.0.0/src/mcp_creator/server.py

@@ -0,0 +1,202 @@
+"""MCP Creator — create, build, and publish Python MCP servers to PyPI."""
+
+from mcp.server.fastmcp import FastMCP
+
+from mcp_creator.tools.creator_profile import get_creator_profile as _get_creator_profile
+from mcp_creator.tools.creator_profile import update_creator_profile as _update_creator_profile
+from mcp_creator.tools.check_setup import check_setup as _check_setup
+from mcp_creator.tools.check_pypi_name import check_pypi_name as _check_pypi_name
+from mcp_creator.tools.scaffold_server import scaffold_server as _scaffold_server
+from mcp_creator.tools.add_tool import add_tool as _add_tool
+from mcp_creator.tools.build_package import build_package as _build_package
+from mcp_creator.tools.publish_package import publish_package as _publish_package
+from mcp_creator.tools.setup_github import setup_github as _setup_github
+from mcp_creator.tools.generate_launchguide import generate_launchguide as _generate_launchguide
+
+mcp = FastMCP("mcp-creator")
+
+
+@mcp.tool(
+    description=(
+        "Load the creator's persistent profile — their setup status, GitHub/PyPI usernames, "
+        "and project history. Call this FIRST in every session. If the profile exists with "
+        "setup_complete=true, skip all onboarding and go straight to building."
+    )
+)
+def get_creator_profile() -> str:
+    """Load creator profile."""
+    return _get_creator_profile()
+
+
+@mcp.tool(
+    description=(
+        "Update the creator's profile after setup steps or project creation. "
+        "Call this after: setup completes, a project is published, or GitHub/PyPI info is learned. "
+        "This persists across sessions so the user never repeats setup."
+    )
+)
+def update_creator_profile(
+    setup_complete: bool | None = None,
+    github_username: str | None = None,
+    pypi_username: str | None = None,
+    default_output_dir: str | None = None,
+    add_project: str | None = None,
+) -> str:
+    """Update creator profile."""
+    return _update_creator_profile(
+        setup_complete=setup_complete,
+        github_username=github_username,
+        pypi_username=pypi_username,
+        default_output_dir=default_output_dir,
+        add_project=add_project,
+    )
+
+
+@mcp.tool(
+    description=(
+        "Check the user's environment for required tools (uv, git, gh CLI, PyPI token). "
+        "Call this after get_creator_profile if setup_complete is false. "
+        "If everything is set up, skip beginner instructions and go straight to building."
+    )
+)
+def check_setup() -> str:
+    """Check what's already set up."""
+    return _check_setup()
+
+
+@mcp.tool(
+    description="Check if a package name is available on PyPI. Call this first before scaffolding."
+)
+def check_pypi_name(package_name: str) -> str:
+    """Check PyPI name availability."""
+    return _check_pypi_name(package_name=package_name)
+
+
+@mcp.tool(
+    description=(
+        "Scaffold a complete, runnable MCP server project. "
+        "Pass the package name, description, and a JSON array of tool definitions. "
+        "Each tool def: {name, description, parameters: [{name, type, required, description, default}], returns}. "
+        "The generated server runs immediately with stub implementations. "
+        "Set paid=true to add license key gating via the MCP Marketplace SDK. "
+        "Set paid_tools to a JSON array of tool names to gate (omit to gate all). "
+        'Set hosting="remote" for an SSE/HTTP server with Dockerfile (default: "local" for stdio).'
+    )
+)
+def scaffold_server(
+    package_name: str,
+    description: str,
+    tools: str,
+    output_dir: str = ".",
+    env_vars: str | None = None,
+    paid: bool = False,
+    paid_tools: str | None = None,
+    hosting: str = "local",
+) -> str:
+    """Scaffold a complete MCP server project."""
+    return _scaffold_server(
+        package_name=package_name,
+        description=description,
+        tools=tools,
+        output_dir=output_dir,
+        env_vars=env_vars,
+        paid=paid,
+        paid_tools=paid_tools,
+        hosting=hosting,
+    )
+
+
+@mcp.tool(
+    description=(
+        "Add a new tool to an existing scaffolded MCP server. "
+        "Pass the project directory and a JSON tool definition. "
+        "Creates the tool module, service stub, test, and updates server.py."
+    )
+)
+def add_tool(project_dir: str, tool: str) -> str:
+    """Add a tool to an existing project."""
+    return _add_tool(project_dir=project_dir, tool=tool)
+
+
+@mcp.tool(
+    description="Build the MCP server package using 'uv build'. Run this after implementing your tools."
+)
+def build_package(project_dir: str) -> str:
+    """Build the package."""
+    return _build_package(project_dir=project_dir)
+
+
+@mcp.tool(
+    description=(
+        "Publish the built package to PyPI using 'uv publish'. "
+        "Requires a PyPI token — either pass it directly or set UV_PUBLISH_TOKEN env var."
+    )
+)
+def publish_package(project_dir: str, token: str | None = None) -> str:
+    """Publish to PyPI."""
+    return _publish_package(project_dir=project_dir, token=token)
+
+
+@mcp.tool(
+    description=(
+        "Initialize git, create a GitHub repo, and push the project. "
+        "Requires the gh CLI to be installed and authenticated. "
+        "Run this after publishing to PyPI so the repo URL can be included in the LAUNCHGUIDE."
+    )
+)
+def setup_github(
+    project_dir: str,
+    repo_name: str,
+    description: str = "",
+    private: bool = False,
+) -> str:
+    """Create GitHub repo and push code."""
+    return _setup_github(
+        project_dir=project_dir,
+        repo_name=repo_name,
+        description=description,
+        private=private,
+    )
+
+
+@mcp.tool(
+    description=(
+        "Generate a LAUNCHGUIDE.md for MCP Marketplace submission. "
+        "Creates a formatted file ready to submit at mcp-marketplace.io. "
+        "Limits: tagline max 100 chars, features max 30 items, tags max 30."
+    )
+)
+def generate_launchguide(
+    project_dir: str,
+    package_name: str,
+    tagline: str,
+    description: str,
+    category: str,
+    features: str,
+    tools_summary: str,
+    tags: str,
+    setup_requirements: str = "No environment variables required.",
+    docs_url: str = "",
+) -> str:
+    """Generate LAUNCHGUIDE.md."""
+    return _generate_launchguide(
+        project_dir=project_dir,
+        package_name=package_name,
+        tagline=tagline,
+        description=description,
+        category=category,
+        features=features,
+        tools_summary=tools_summary,
+        tags=tags,
+        setup_requirements=setup_requirements,
+        docs_url=docs_url,
+    )
+
+
+def main():
+    """Run the MCP Creator server."""
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()