mcp-wizard-generators 0.5.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (159) hide show
  1. mcp_wizard_generators-0.5.0/.github/workflows/ci.yml +27 -0
  2. mcp_wizard_generators-0.5.0/.github/workflows/publish-github-release.yml +62 -0
  3. mcp_wizard_generators-0.5.0/.github/workflows/publish-pypi.yml +245 -0
  4. mcp_wizard_generators-0.5.0/.github/workflows/quality.yml +142 -0
  5. mcp_wizard_generators-0.5.0/.github/workflows/semgrep.yml +56 -0
  6. mcp_wizard_generators-0.5.0/.gitignore +20 -0
  7. mcp_wizard_generators-0.5.0/CODE_OF_CONDUCT.md +135 -0
  8. mcp_wizard_generators-0.5.0/CONTRIBUTING.md +55 -0
  9. mcp_wizard_generators-0.5.0/LICENSE +21 -0
  10. mcp_wizard_generators-0.5.0/Makefile +102 -0
  11. mcp_wizard_generators-0.5.0/PKG-INFO +388 -0
  12. mcp_wizard_generators-0.5.0/README.md +351 -0
  13. mcp_wizard_generators-0.5.0/SECURITY.md +26 -0
  14. mcp_wizard_generators-0.5.0/codecov.yml +17 -0
  15. mcp_wizard_generators-0.5.0/docs/local-dev.md +124 -0
  16. mcp_wizard_generators-0.5.0/pyproject.toml +108 -0
  17. mcp_wizard_generators-0.5.0/scripts/bootstrap.ps1 +30 -0
  18. mcp_wizard_generators-0.5.0/scripts/bootstrap.sh +23 -0
  19. mcp_wizard_generators-0.5.0/scripts/clean.ps1 +19 -0
  20. mcp_wizard_generators-0.5.0/scripts/clean.sh +10 -0
  21. mcp_wizard_generators-0.5.0/scripts/cli-smoke.ps1 +34 -0
  22. mcp_wizard_generators-0.5.0/scripts/cli-smoke.sh +34 -0
  23. mcp_wizard_generators-0.5.0/scripts/compute_pep440_version.py +193 -0
  24. mcp_wizard_generators-0.5.0/scripts/compute_pep440_version.sh +16 -0
  25. mcp_wizard_generators-0.5.0/scripts/dist.ps1 +40 -0
  26. mcp_wizard_generators-0.5.0/scripts/dist.sh +22 -0
  27. mcp_wizard_generators-0.5.0/scripts/e2e.ps1 +21 -0
  28. mcp_wizard_generators-0.5.0/scripts/e2e.sh +19 -0
  29. mcp_wizard_generators-0.5.0/scripts/format.ps1 +17 -0
  30. mcp_wizard_generators-0.5.0/scripts/format.sh +14 -0
  31. mcp_wizard_generators-0.5.0/scripts/lint.ps1 +20 -0
  32. mcp_wizard_generators-0.5.0/scripts/lint.sh +18 -0
  33. mcp_wizard_generators-0.5.0/scripts/lock_python_mcp.py +79 -0
  34. mcp_wizard_generators-0.5.0/scripts/test.ps1 +27 -0
  35. mcp_wizard_generators-0.5.0/scripts/test.sh +24 -0
  36. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/__init__.py +34 -0
  37. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/__main__.py +5 -0
  38. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/cli.py +191 -0
  39. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/codegen.py +113 -0
  40. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/findings.py +214 -0
  41. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/models.py +261 -0
  42. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/openapi.py +304 -0
  43. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/package_name.py +70 -0
  44. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/packaging/__init__.py +5 -0
  45. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/packaging/ziputil.py +50 -0
  46. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/paths.py +38 -0
  47. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/pipeline.py +126 -0
  48. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/__init__.py +1 -0
  49. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/agentcore/__init__.py +5 -0
  50. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/agentcore/plugin.py +274 -0
  51. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/python_mcp/__init__.py +5 -0
  52. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/python_mcp/annotations.py +173 -0
  53. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/python_mcp/client_template.py +278 -0
  54. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/python_mcp/lock/requirements.in +6 -0
  55. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/python_mcp/lock/requirements.txt +609 -0
  56. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/python_mcp/plugin.py +1122 -0
  57. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/plugins/python_mcp/tests_template.py +582 -0
  58. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/python_mcp.py +244 -0
  59. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/registry.py +63 -0
  60. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/rules/__init__.py +15 -0
  61. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/rules/anthropic.py +43 -0
  62. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/rules/base.py +37 -0
  63. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/rules/cursor.py +44 -0
  64. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/rules/hooks.py +26 -0
  65. mcp_wizard_generators-0.5.0/src/mcp_wizard_generators/toolmap.py +84 -0
  66. mcp_wizard_generators-0.5.0/tests/e2e_harness.py +220 -0
  67. mcp_wizard_generators-0.5.0/tests/fixtures/pets_tiny.ir.json +57 -0
  68. mcp_wizard_generators-0.5.0/tests/fixtures/pets_tiny.openapi.yaml +51 -0
  69. mcp_wizard_generators-0.5.0/tests/fixtures/petstore3.openapi.json +1270 -0
  70. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/.env.example +3 -0
  71. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/README.md +18 -0
  72. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/deploy/agentcore/README.md +12 -0
  73. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/deploy/agentcore/agent-config.stub.json +14 -0
  74. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/generation-manifest.json +24 -0
  75. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/pyproject.toml +16 -0
  76. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/src/pets_tiny_mcp/__init__.py +3 -0
  77. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/src/pets_tiny_mcp/client.py +17 -0
  78. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/src/pets_tiny_mcp/server.py +29 -0
  79. mcp_wizard_generators-0.5.0/tests/goldens/agentcore_pets_tiny/src/pets_tiny_mcp/tools.py +43 -0
  80. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/.cursor/mcp.json +14 -0
  81. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/.env.example +6 -0
  82. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/README.md +121 -0
  83. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/generation-manifest.json +27 -0
  84. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/pyproject.toml +28 -0
  85. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/requirements.lock +4 -0
  86. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/requirements.txt +3 -0
  87. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/src/pets_tiny_mcp/__init__.py +6 -0
  88. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/src/pets_tiny_mcp/__main__.py +6 -0
  89. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/src/pets_tiny_mcp/client.py +269 -0
  90. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/src/pets_tiny_mcp/server.py +51 -0
  91. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/src/pets_tiny_mcp/verify.py +178 -0
  92. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/tests/conftest.py +56 -0
  93. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/tests/test_auth.py +21 -0
  94. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/tests/test_http_errors.py +83 -0
  95. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/tests/test_redaction.py +49 -0
  96. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny/tests/test_tools.py +61 -0
  97. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/.cursor/mcp.json +17 -0
  98. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/.env.example +8 -0
  99. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/README.md +129 -0
  100. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/SECURITY-NOTES.md +9 -0
  101. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/generation-manifest.json +31 -0
  102. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/pyproject.toml +28 -0
  103. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/requirements.lock +4 -0
  104. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/requirements.txt +3 -0
  105. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/src/pets_tiny_mcp/__init__.py +6 -0
  106. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/src/pets_tiny_mcp/__main__.py +6 -0
  107. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/src/pets_tiny_mcp/client.py +287 -0
  108. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/src/pets_tiny_mcp/server.py +51 -0
  109. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/src/pets_tiny_mcp/verify.py +178 -0
  110. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/tests/conftest.py +58 -0
  111. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/tests/test_auth.py +35 -0
  112. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/tests/test_http_errors.py +83 -0
  113. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/tests/test_redaction.py +57 -0
  114. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_api_key_query/tests/test_tools.py +61 -0
  115. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/.cursor/mcp.json +18 -0
  116. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/.env.example +10 -0
  117. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/README.md +125 -0
  118. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/generation-manifest.json +34 -0
  119. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/pyproject.toml +28 -0
  120. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/requirements.lock +4 -0
  121. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/requirements.txt +3 -0
  122. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/src/pets_tiny_mcp/__init__.py +6 -0
  123. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/src/pets_tiny_mcp/__main__.py +6 -0
  124. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/src/pets_tiny_mcp/client.py +348 -0
  125. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/src/pets_tiny_mcp/server.py +51 -0
  126. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/src/pets_tiny_mcp/verify.py +178 -0
  127. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/tests/conftest.py +58 -0
  128. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/tests/test_auth.py +43 -0
  129. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/tests/test_http_errors.py +83 -0
  130. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/tests/test_redaction.py +60 -0
  131. mcp_wizard_generators-0.5.0/tests/goldens/python_mcp_pets_tiny_oauth2/tests/test_tools.py +61 -0
  132. mcp_wizard_generators-0.5.0/tests/test_agentcore_golden.py +48 -0
  133. mcp_wizard_generators-0.5.0/tests/test_compute_pep440_version.py +174 -0
  134. mcp_wizard_generators-0.5.0/tests/test_findings.py +292 -0
  135. mcp_wizard_generators-0.5.0/tests/test_generated_code_hardening.py +288 -0
  136. mcp_wizard_generators-0.5.0/tests/test_ir_edge_cases.py +347 -0
  137. mcp_wizard_generators-0.5.0/tests/test_ir_fidelity.py +275 -0
  138. mcp_wizard_generators-0.5.0/tests/test_local_scripts.py +100 -0
  139. mcp_wizard_generators-0.5.0/tests/test_openapi_coerce.py +429 -0
  140. mcp_wizard_generators-0.5.0/tests/test_package_name.py +83 -0
  141. mcp_wizard_generators-0.5.0/tests/test_paths_cross_platform.py +117 -0
  142. mcp_wizard_generators-0.5.0/tests/test_public_hygiene.py +191 -0
  143. mcp_wizard_generators-0.5.0/tests/test_publish_packaging.py +257 -0
  144. mcp_wizard_generators-0.5.0/tests/test_python_mcp_activate_and_mcp2.py +148 -0
  145. mcp_wizard_generators-0.5.0/tests/test_python_mcp_client_hardening.py +542 -0
  146. mcp_wizard_generators-0.5.0/tests/test_python_mcp_e2e.py +86 -0
  147. mcp_wizard_generators-0.5.0/tests/test_python_mcp_generated_tests.py +281 -0
  148. mcp_wizard_generators-0.5.0/tests/test_python_mcp_golden.py +190 -0
  149. mcp_wizard_generators-0.5.0/tests/test_python_mcp_lock.py +145 -0
  150. mcp_wizard_generators-0.5.0/tests/test_python_mcp_ops.py +78 -0
  151. mcp_wizard_generators-0.5.0/tests/test_python_mcp_security.py +406 -0
  152. mcp_wizard_generators-0.5.0/tests/test_python_mcp_typed_schemas.py +389 -0
  153. mcp_wizard_generators-0.5.0/tests/test_python_mcp_verify.py +157 -0
  154. mcp_wizard_generators-0.5.0/tests/test_registry.py +28 -0
  155. mcp_wizard_generators-0.5.0/tests/test_rules_stubs.py +27 -0
  156. mcp_wizard_generators-0.5.0/tests/test_server_urls.py +127 -0
  157. mcp_wizard_generators-0.5.0/tests/test_toolmap.py +63 -0
  158. mcp_wizard_generators-0.5.0/tests/test_zip.py +23 -0
  159. mcp_wizard_generators-0.5.0/tox.ini +17 -0
@@ -0,0 +1,27 @@
1
+ # Lint, test, coverage gate, Semgrep, and Codecov upload for mcp-wizard-generators.
2
+ # Requires repo/org secret CODECOV_TOKEN (or Codecov GitHub App) for uploads
3
+ # on private repos and for reliable main-branch uploads after going public.
4
+ # PR CI does not require PyPI / Trusted Publisher secrets.
5
+ #
6
+ # Quality steps live in quality.yml (workflow_call) and are shared with publish-pypi.
7
+
8
+ name: CI
9
+
10
+ on:
11
+ push:
12
+ branches:
13
+ - main
14
+ - "release/**"
15
+ pull_request:
16
+ workflow_dispatch:
17
+
18
+ permissions:
19
+ contents: read
20
+
21
+ jobs:
22
+ quality:
23
+ name: Quality
24
+ uses: ./.github/workflows/quality.yml
25
+ secrets:
26
+ CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
27
+ SEMGREP_APP_TOKEN: ${{ secrets.SEMGREP_APP_TOKEN }}
@@ -0,0 +1,62 @@
1
+ # Build mcp-wizard-generators on version tags and attach wheel/sdist to a GitHub Release.
2
+ #
3
+ # GitHub Packages does NOT support a PyPI registry (roadmap closed as not planned).
4
+ # Do NOT twine-upload to *.pypi.pkg.github.com / upload.pypi.pkg.github.com — those
5
+ # hosts fail with 404 or SSL hostname mismatch. There is no GHP PyPI upload here.
6
+ #
7
+ # Preferred install (once published): pip install mcp-wizard-generators
8
+ # Interim: pip install git+https://github.com/agentic-ai-tools/mcp-wizard-generators.git@v0.3.0
9
+ # Or download wheel/sdist from the GitHub Release assets for that tag.
10
+ # Optional TestPyPI/PyPI OIDC publish: see publish-pypi.yml (Trusted Publisher).
11
+
12
+ name: Build and GitHub Release
13
+
14
+ on:
15
+ push:
16
+ tags:
17
+ - "v*"
18
+ workflow_dispatch:
19
+
20
+ permissions:
21
+ contents: write
22
+
23
+ jobs:
24
+ release:
25
+ runs-on: ubuntu-latest
26
+ steps:
27
+ - name: Checkout
28
+ uses: actions/checkout@v7
29
+
30
+ - name: Set up Python
31
+ uses: actions/setup-python@v7
32
+ with:
33
+ python-version: "3.12"
34
+
35
+ - name: Install build tools
36
+ run: python -m pip install --upgrade pip build twine
37
+
38
+ - name: Build wheel and sdist
39
+ run: python -m build
40
+
41
+ - name: Check dist artifacts
42
+ run: |
43
+ python -m twine check dist/*
44
+ ls -la dist/
45
+
46
+ # Publish step: attach dist/* as GitHub Release assets (GITHUB_TOKEN works).
47
+ # Intentionally no Twine publish to GitHub Packages (no PyPI registry there).
48
+ - name: Create GitHub Release and upload dist assets
49
+ if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
50
+ env:
51
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
52
+ run: >
53
+ gh release create "${GITHUB_REF_NAME}" dist/*
54
+ --title "${GITHUB_REF_NAME}"
55
+ --generate-notes
56
+ --verify-tag
57
+
58
+ - name: Skip Release upload (workflow_dispatch)
59
+ if: github.event_name == 'workflow_dispatch'
60
+ run: |
61
+ echo "workflow_dispatch: build + twine check only (no GitHub Release upload)."
62
+ echo "Push a v* tag to create a Release with dist assets."
@@ -0,0 +1,245 @@
1
+ # Branch-based OIDC Trusted Publisher publish for PyPI org agentic-ai-tools /
2
+ # project mcp-wizard-generators.
3
+ #
4
+ # Does NOT run on PRs (PR CI stays free of publish credentials).
5
+ # No long-lived PyPI API tokens — uses GitHub OIDC → PyPI Trusted Publisher.
6
+ #
7
+ # Channels:
8
+ # feature branches → {base}.dev{N} → TestPyPI only
9
+ # main → {base}rc{N} → TestPyPI only
10
+ # release/X.Y.Z → X.Y.Z → TestPyPI then PyPI
11
+ #
12
+ # Quality (lint + test + Semgrep) must pass before build/publish on every channel.
13
+ #
14
+ # OIDC upload gate: set repository variable ENABLE_PYPI_PUBLISH=true only after
15
+ # Trusted Publisher is linked for this workflow + envs testpypi/pypi. When unset
16
+ # or not exactly "true", version/quality/build still run (dry-run) but publish
17
+ # jobs are skipped so feature-branch pushes do not fail PR required checks with
18
+ # invalid-publisher. Set ENABLE_PYPI_PUBLISH=false (or unset) as an emergency
19
+ # kill-switch once publishing is enabled.
20
+ #
21
+ # Triggers are push + workflow_dispatch only (never PR events), so PR CI stays
22
+ # free of publish credentials. Tag pushes still attach dist via
23
+ # publish-github-release.yml.
24
+
25
+ name: Publish to TestPyPI / PyPI
26
+
27
+ on:
28
+ push:
29
+ branches:
30
+ - "**"
31
+ workflow_dispatch:
32
+
33
+ permissions:
34
+ contents: read
35
+
36
+ jobs:
37
+ version:
38
+ name: Compute PEP 440 version
39
+ if: github.actor != 'dependabot[bot]'
40
+ runs-on: ubuntu-latest
41
+ outputs:
42
+ version: ${{ steps.compute.outputs.version }}
43
+ branch_kind: ${{ steps.compute.outputs.branch_kind }}
44
+ publish_pypi: ${{ steps.compute.outputs.publish_pypi }}
45
+ steps:
46
+ - uses: actions/checkout@v7
47
+
48
+ - name: Set up Python
49
+ uses: actions/setup-python@v7
50
+ with:
51
+ python-version: "3.12"
52
+
53
+ - name: Install packaging helpers
54
+ run: |
55
+ python -m pip install --upgrade pip
56
+ python -m pip install "packaging>=24.0"
57
+
58
+ - name: Compute version
59
+ id: compute
60
+ run: |
61
+ set -eu
62
+ VERSION=$(python scripts/compute_pep440_version.py)
63
+ echo "$VERSION" > version.txt
64
+ echo "version=$VERSION" >> "$GITHUB_OUTPUT"
65
+ REF="${GITHUB_REF_NAME}"
66
+ if [ "$REF" = "main" ]; then
67
+ KIND=main
68
+ PUBLISH_PYPI=false
69
+ elif [[ "$REF" == release/* ]]; then
70
+ KIND=release
71
+ PUBLISH_PYPI=true
72
+ else
73
+ KIND=feature
74
+ PUBLISH_PYPI=false
75
+ fi
76
+ echo "branch_kind=$KIND" >> "$GITHUB_OUTPUT"
77
+ echo "publish_pypi=$PUBLISH_PYPI" >> "$GITHUB_OUTPUT"
78
+ echo "Computed version=$VERSION kind=$KIND publish_pypi=$PUBLISH_PYPI"
79
+
80
+ - name: Upload version.txt
81
+ uses: actions/upload-artifact@v7
82
+ with:
83
+ name: pep440-version
84
+ path: version.txt
85
+
86
+ quality:
87
+ name: Quality
88
+ needs: version
89
+ if: github.actor != 'dependabot[bot]'
90
+ uses: ./.github/workflows/quality.yml
91
+ secrets:
92
+ CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
93
+ SEMGREP_APP_TOKEN: ${{ secrets.SEMGREP_APP_TOKEN }}
94
+
95
+ build:
96
+ name: Build dist
97
+ needs: [version, quality]
98
+ if: >
99
+ github.actor != 'dependabot[bot]' &&
100
+ needs.version.result == 'success' &&
101
+ needs.quality.result == 'success'
102
+ runs-on: ubuntu-latest
103
+ steps:
104
+ - uses: actions/checkout@v7
105
+
106
+ - name: Set up Python
107
+ uses: actions/setup-python@v7
108
+ with:
109
+ python-version: "3.12"
110
+
111
+ - name: Install build tools
112
+ run: |
113
+ python -m pip install --upgrade pip
114
+ python -m pip install build twine "packaging>=24.0"
115
+
116
+ - name: Download version.txt
117
+ uses: actions/download-artifact@v8
118
+ with:
119
+ name: pep440-version
120
+ path: .
121
+
122
+ - name: Rewrite version into pyproject + __init__ (CI-only)
123
+ run: |
124
+ set -eu
125
+ VERSION=$(tr -d '[:space:]' < version.txt)
126
+ echo "Rewriting package version to $VERSION (workspace only, not pushed)"
127
+ python <<'PY'
128
+ from pathlib import Path
129
+ import re
130
+ import sys
131
+
132
+ version = Path("version.txt").read_text(encoding="utf-8").strip()
133
+ if not version:
134
+ sys.exit("empty version.txt")
135
+
136
+ pyproject = Path("pyproject.toml")
137
+ text = pyproject.read_text(encoding="utf-8")
138
+ new_text, n = re.subn(
139
+ r'(?m)^(version\s*=\s*)"[^"]*"',
140
+ rf'\1"{version}"',
141
+ text,
142
+ count=1,
143
+ )
144
+ if n != 1:
145
+ sys.exit(f"failed to rewrite pyproject version (replacements={n})")
146
+ pyproject.write_text(new_text, encoding="utf-8")
147
+
148
+ init = Path("src/mcp_wizard_generators/__init__.py")
149
+ init_text = init.read_text(encoding="utf-8")
150
+ new_init, n = re.subn(
151
+ r'(?m)^(__version__\s*=\s*)["\'][^"\']+["\']',
152
+ rf'\1"{version}"',
153
+ init_text,
154
+ count=1,
155
+ )
156
+ if n != 1:
157
+ sys.exit(f"failed to rewrite __version__ (replacements={n})")
158
+ init.write_text(new_init, encoding="utf-8")
159
+ print(f"rewrote metadata to {version}")
160
+ PY
161
+
162
+ - name: Build wheel and sdist
163
+ run: python -m build
164
+
165
+ - name: Twine check
166
+ run: python -m twine check dist/*
167
+
168
+ - name: Assert metadata version matches computed
169
+ run: |
170
+ set -eu
171
+ python - <<'PY'
172
+ import sys
173
+ from pathlib import Path
174
+
175
+ expected = Path("version.txt").read_text(encoding="utf-8").strip()
176
+ wheels = list(Path("dist").glob("*.whl"))
177
+ sdists = list(Path("dist").glob("*.tar.gz"))
178
+ if not wheels or not sdists:
179
+ sys.exit(f"missing dist artifacts: {list(Path('dist').iterdir())}")
180
+ for path in wheels + sdists:
181
+ if expected not in path.name:
182
+ sys.exit(f"artifact {path.name!r} missing version {expected!r}")
183
+ print(f"artifacts match version {expected}")
184
+ PY
185
+
186
+ - name: Upload dist artifacts
187
+ uses: actions/upload-artifact@v7
188
+ with:
189
+ name: python-package-distributions
190
+ path: dist/
191
+
192
+ publish-testpypi:
193
+ name: Publish to TestPyPI (OIDC)
194
+ needs: [version, quality, build]
195
+ if: >
196
+ github.actor != 'dependabot[bot]' &&
197
+ vars.ENABLE_PYPI_PUBLISH == 'true' &&
198
+ needs.version.result == 'success' &&
199
+ needs.quality.result == 'success' &&
200
+ needs.build.result == 'success'
201
+ runs-on: ubuntu-latest
202
+ environment: testpypi
203
+ permissions:
204
+ id-token: write
205
+ contents: read
206
+ steps:
207
+ - name: Download dist artifacts
208
+ uses: actions/download-artifact@v8
209
+ with:
210
+ name: python-package-distributions
211
+ path: dist/
212
+
213
+ - name: Publish to TestPyPI
214
+ uses: pypa/gh-action-pypi-publish@release/v1
215
+ with:
216
+ repository-url: https://test.pypi.org/legacy/
217
+ packages-dir: dist/
218
+
219
+ publish-pypi:
220
+ name: Publish to PyPI (OIDC)
221
+ needs: [version, quality, build, publish-testpypi]
222
+ if: >
223
+ github.actor != 'dependabot[bot]' &&
224
+ vars.ENABLE_PYPI_PUBLISH == 'true' &&
225
+ needs.version.outputs.publish_pypi == 'true' &&
226
+ needs.version.result == 'success' &&
227
+ needs.quality.result == 'success' &&
228
+ needs.build.result == 'success' &&
229
+ needs.publish-testpypi.result == 'success'
230
+ runs-on: ubuntu-latest
231
+ environment: pypi
232
+ permissions:
233
+ id-token: write
234
+ contents: read
235
+ steps:
236
+ - name: Download dist artifacts
237
+ uses: actions/download-artifact@v8
238
+ with:
239
+ name: python-package-distributions
240
+ path: dist/
241
+
242
+ - name: Publish to PyPI
243
+ uses: pypa/gh-action-pypi-publish@release/v1
244
+ with:
245
+ packages-dir: dist/
@@ -0,0 +1,142 @@
1
+ # Reusable quality gate: lint + test (3.11/3.12) + Semgrep.
2
+ # Called by ci.yml and publish-pypi.yml (must pass before any index publish).
3
+
4
+ name: Quality
5
+
6
+ on:
7
+ workflow_call:
8
+ secrets:
9
+ CODECOV_TOKEN:
10
+ required: false
11
+ SEMGREP_APP_TOKEN:
12
+ required: false
13
+
14
+ permissions:
15
+ contents: read
16
+
17
+ jobs:
18
+ lint:
19
+ name: Lint
20
+ runs-on: ubuntu-latest
21
+ steps:
22
+ - uses: actions/checkout@v7
23
+
24
+ - name: Set up Python
25
+ uses: actions/setup-python@v7
26
+ with:
27
+ python-version: "3.12"
28
+
29
+ - name: Install package + dev tools
30
+ run: |
31
+ python -m pip install --upgrade pip
32
+ python -m pip install -e ".[dev]"
33
+
34
+ - name: Ruff format check
35
+ run: ruff format --check .
36
+
37
+ - name: Ruff lint
38
+ run: ruff check .
39
+
40
+ - name: Generated-project lock is up to date
41
+ run: python scripts/lock_python_mcp.py --check
42
+
43
+ test:
44
+ name: Test (coverage)
45
+ runs-on: ubuntu-latest
46
+ strategy:
47
+ fail-fast: false
48
+ matrix:
49
+ python-version: ["3.11", "3.12"]
50
+ steps:
51
+ - uses: actions/checkout@v7
52
+
53
+ - name: Set up Python ${{ matrix.python-version }}
54
+ uses: actions/setup-python@v7
55
+ with:
56
+ python-version: ${{ matrix.python-version }}
57
+
58
+ - name: Install package + dev tools
59
+ run: |
60
+ python -m pip install --upgrade pip
61
+ python -m pip install -e ".[dev]"
62
+
63
+ - name: Pytest with coverage
64
+ run: >
65
+ python -m pytest -m "not e2e"
66
+ --cov=mcp_wizard_generators
67
+ --cov-report=term-missing
68
+ --cov-report=xml:coverage.xml
69
+ --cov-report=lcov:coverage.lcov
70
+
71
+ - name: Upload coverage to Codecov
72
+ if: matrix.python-version == '3.12'
73
+ uses: codecov/codecov-action@v7
74
+ with:
75
+ token: ${{ secrets.CODECOV_TOKEN }}
76
+ files: coverage.xml,coverage.lcov
77
+ flags: unittests
78
+ name: mcp-wizard-generators
79
+ # Token may be unset until Codecov App / CODECOV_TOKEN is wired;
80
+ # local coverage --cov-fail-under still gates the job above.
81
+ fail_ci_if_error: false
82
+
83
+ e2e:
84
+ name: E2E (${{ matrix.os }}, ${{ matrix.python-version }})
85
+ runs-on: ${{ matrix.os }}
86
+ strategy:
87
+ fail-fast: false
88
+ matrix:
89
+ include:
90
+ - os: ubuntu-latest
91
+ python-version: "3.11"
92
+ - os: ubuntu-latest
93
+ python-version: "3.13"
94
+ - os: windows-latest
95
+ python-version: "3.12"
96
+ steps:
97
+ - uses: actions/checkout@v7
98
+
99
+ - name: Set up Python ${{ matrix.python-version }}
100
+ uses: actions/setup-python@v7
101
+ with:
102
+ python-version: ${{ matrix.python-version }}
103
+
104
+ - name: Install package + dev tools
105
+ run: |
106
+ python -m pip install --upgrade pip
107
+ python -m pip install -e ".[dev]"
108
+
109
+ # Installs a generated project from requirements.lock (--require-hashes)
110
+ # into a fresh venv and calls a tool over stdio.
111
+ - name: Pytest e2e
112
+ run: python -m pytest -m e2e -p no:cacheprovider
113
+
114
+ semgrep:
115
+ name: Semgrep
116
+ runs-on: ubuntu-latest
117
+ container:
118
+ image: semgrep/semgrep
119
+ if: github.actor != 'dependabot[bot]'
120
+ env:
121
+ SEMGREP_APP_TOKEN: ${{ secrets.SEMGREP_APP_TOKEN }}
122
+ steps:
123
+ - uses: actions/checkout@v7
124
+
125
+ - name: Semgrep scan (App token or OSS fallback)
126
+ run: |
127
+ set -eu
128
+ # Exclude generated goldens (fixtures, not product source).
129
+ EXCLUDES="--exclude=tests/goldens"
130
+ if [ -n "${SEMGREP_APP_TOKEN:-}" ]; then
131
+ echo "Using Semgrep AppSec Platform (SEMGREP_APP_TOKEN / App install)."
132
+ semgrep ci $EXCLUDES
133
+ else
134
+ echo "SEMGREP_APP_TOKEN unset — OSS rules with --error (library fail-closed)."
135
+ echo "Install the Semgrep GitHub App on the org and/or set SEMGREP_APP_TOKEN."
136
+ semgrep scan \
137
+ --config p/python \
138
+ --config p/security-audit \
139
+ --config p/secrets \
140
+ --error \
141
+ $EXCLUDES
142
+ fi
@@ -0,0 +1,56 @@
1
+ # Semgrep AppSec Platform (recommended) or OSS rules fallback.
2
+ #
3
+ # Org setup (required for App-managed policies):
4
+ # 1. Install the Semgrep GitHub App on the agentic-ai-tools org
5
+ # (or grant it access to this repository).
6
+ # 2. Add repository/org secret SEMGREP_APP_TOKEN from Semgrep AppSec Platform
7
+ # (Settings → Tokens), OR rely on the App-managed onboarding token path.
8
+ #
9
+ # Official path today: semgrep/semgrep container + `semgrep ci` (semgrep-action
10
+ # is deprecated). When SEMGREP_APP_TOKEN is unset, fall back to curated OSS
11
+ # rules with --error so library CI still fails on findings.
12
+
13
+ name: Semgrep
14
+
15
+ on:
16
+ pull_request: {}
17
+ push:
18
+ branches: [main]
19
+ schedule:
20
+ - cron: "27 15 * * *"
21
+ workflow_dispatch: {}
22
+
23
+ permissions:
24
+ contents: read
25
+
26
+ jobs:
27
+ semgrep:
28
+ name: semgrep/ci
29
+ runs-on: ubuntu-latest
30
+ container:
31
+ image: semgrep/semgrep
32
+ if: github.actor != 'dependabot[bot]'
33
+ env:
34
+ SEMGREP_APP_TOKEN: ${{ secrets.SEMGREP_APP_TOKEN }}
35
+ steps:
36
+ - uses: actions/checkout@v7
37
+
38
+ - name: Semgrep scan (App token or OSS fallback)
39
+ run: |
40
+ set -eu
41
+ # Exclude generated goldens (fixtures, not product source).
42
+ EXCLUDES="--exclude=tests/goldens"
43
+ if [ -n "${SEMGREP_APP_TOKEN:-}" ]; then
44
+ echo "Using Semgrep AppSec Platform (SEMGREP_APP_TOKEN / App install)."
45
+ # App policies decide blocking; `semgrep ci` exits non-zero on blocking findings.
46
+ semgrep ci $EXCLUDES
47
+ else
48
+ echo "SEMGREP_APP_TOKEN unset — OSS rules with --error (library fail-closed)."
49
+ echo "Install the Semgrep GitHub App on the org and/or set SEMGREP_APP_TOKEN."
50
+ semgrep scan \
51
+ --config p/python \
52
+ --config p/security-audit \
53
+ --config p/secrets \
54
+ --error \
55
+ $EXCLUDES
56
+ fi
@@ -0,0 +1,20 @@
1
+ __pycache__/
2
+ *.py[cod]
3
+ *.egg-info/
4
+ .eggs/
5
+ dist/
6
+ build/
7
+ .pytest_cache/
8
+ .mypy_cache/
9
+ .ruff_cache/
10
+ .tox/
11
+ .venv/
12
+ venv/
13
+ *.zip
14
+ .smoke-out/
15
+ .smoke-out.zip
16
+ .DS_Store
17
+ coverage.xml
18
+ coverage.lcov
19
+ .coverage
20
+ htmlcov/
@@ -0,0 +1,135 @@
1
+ # Contributor Covenant Code of Conduct
2
+
3
+ ## Our Pledge
4
+
5
+ We as members, contributors, and leaders pledge to make participation in our
6
+ community a harassment-free experience for everyone, regardless of age, body
7
+ size, visible or invisible disability, ethnicity, sex characteristics, gender
8
+ identity and expression, level of experience, education, socio-economic status,
9
+ nationality, personal appearance, race, caste, color, religion, or sexual
10
+ identity and orientation.
11
+
12
+ We pledge to act and interact in ways that contribute to an open, welcoming,
13
+ diverse, inclusive, and healthy community.
14
+
15
+ ## Our Standards
16
+
17
+ Examples of behavior that contributes to a positive environment for our
18
+ community include:
19
+
20
+ * Demonstrating empathy and kindness toward other people
21
+ * Being respectful of differing opinions, viewpoints, and experiences
22
+ * Giving and gracefully accepting constructive feedback
23
+ * Accepting responsibility and apologizing to those affected by our mistakes,
24
+ and learning from the experience
25
+ * Focusing on what is best not just for us as individuals, but for the overall
26
+ community
27
+
28
+ Examples of unacceptable behavior include:
29
+
30
+ * The use of sexualized language or imagery, and sexual attention or advances of
31
+ any kind
32
+ * Trolling, insulting or derogatory comments, and personal or political attacks
33
+ * Public or private harassment
34
+ * Publishing others' private information, such as a physical or email address,
35
+ without their explicit permission
36
+ * Other conduct which could reasonably be considered inappropriate in a
37
+ professional setting
38
+
39
+ ## Enforcement Responsibilities
40
+
41
+ Community leaders are responsible for clarifying and enforcing our standards of
42
+ acceptable behavior and will take appropriate and fair corrective action in
43
+ response to any behavior that they deem inappropriate, threatening, offensive,
44
+ or harmful.
45
+
46
+ Community leaders have the right and responsibility to remove, edit, or reject
47
+ comments, commits, code, wiki edits, issues, and other contributions that are
48
+ not aligned to this Code of Conduct, and will communicate reasons for moderation
49
+ decisions when appropriate.
50
+
51
+ ## Scope
52
+
53
+ This Code of Conduct applies within all community spaces, and also applies when
54
+ an individual is officially representing the community in public spaces.
55
+ Examples of representing our community include using an official e-mail address,
56
+ posting via an official social media account, or acting as an appointed
57
+ representative at an online or offline event.
58
+
59
+ ## Enforcement
60
+
61
+ Instances of abusive, harassing, or otherwise unacceptable behavior may be
62
+ reported privately to the project maintainers.
63
+
64
+ **Do not open a public GitHub issue for Code of Conduct reports.** Prefer:
65
+
66
+ 1. [GitHub private vulnerability reporting](https://github.com/agentic-ai-tools/mcp-wizard-generators/security/advisories/new)
67
+ for this repository (when enabled), as described in [`SECURITY.md`](SECURITY.md), or
68
+ 2. The maintainer contact listed on the
69
+ [`agentic-ai-tools`](https://github.com/agentic-ai-tools) organization profile.
70
+
71
+ All complaints will be reviewed and investigated promptly and fairly.
72
+
73
+ All community leaders are obligated to respect the privacy and security of the
74
+ reporter of any incident.
75
+
76
+ ## Enforcement Guidelines
77
+
78
+ Community leaders will follow these Community Impact Guidelines in determining
79
+ the consequences for any action they deem in violation of this Code of Conduct:
80
+
81
+ ### 1. Correction
82
+
83
+ **Community Impact**: Use of inappropriate language or other behavior deemed
84
+ unprofessional or unwelcome in the community.
85
+
86
+ **Consequence**: A private, written warning from community leaders, providing
87
+ clarity around the nature of the violation and an explanation of why the
88
+ behavior was inappropriate. A public apology may be requested.
89
+
90
+ ### 2. Warning
91
+
92
+ **Community Impact**: A violation through a single incident or series of
93
+ actions.
94
+
95
+ **Consequence**: A warning with consequences for continued behavior. No
96
+ interaction with the people involved, including unsolicited interaction with
97
+ those enforcing the Code of Conduct, for a specified period of time. This
98
+ includes avoiding interactions in community spaces as well as external channels
99
+ like social media. Violating these terms may lead to a temporary or permanent
100
+ ban.
101
+
102
+ ### 3. Temporary Ban
103
+
104
+ **Community Impact**: A serious violation of community standards, including
105
+ sustained inappropriate behavior.
106
+
107
+ **Consequence**: A temporary ban from any sort of interaction or public
108
+ communication with the community for a specified period of time. No public or
109
+ private interaction with the people involved, including unsolicited interaction
110
+ with those enforcing the Code of Conduct, is allowed during this period.
111
+ Violating these terms may lead to a permanent ban.
112
+
113
+ ### 4. Permanent Ban
114
+
115
+ **Community Impact**: Demonstrating a pattern of violation of community
116
+ standards, including sustained inappropriate behavior, harassment of an
117
+ individual, or aggression toward or disparagement of classes of individuals.
118
+
119
+ **Consequence**: A permanent ban from any sort of public interaction within the
120
+ community.
121
+
122
+ ## Attribution
123
+
124
+ This Code of Conduct is adapted from the
125
+ [Contributor Covenant](https://www.contributor-covenant.org), version 2.1,
126
+ available at
127
+ [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).
128
+
129
+ Community Impact Guidelines were inspired by
130
+ [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
131
+
132
+ For answers to common questions about this code of conduct, see the FAQ at
133
+ [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq).
134
+ Translations are available at
135
+ [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations).