openapi-mcpforge 0.1.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 (164) hide show
  1. openapi_mcpforge-0.1.0/.github/workflows/ci.yml +50 -0
  2. openapi_mcpforge-0.1.0/.gitignore +20 -0
  3. openapi_mcpforge-0.1.0/.pre-commit-config.yaml +18 -0
  4. openapi_mcpforge-0.1.0/CHANGELOG.md +41 -0
  5. openapi_mcpforge-0.1.0/LICENSE +21 -0
  6. openapi_mcpforge-0.1.0/Makefile +18 -0
  7. openapi_mcpforge-0.1.0/PKG-INFO +1566 -0
  8. openapi_mcpforge-0.1.0/README.md +1537 -0
  9. openapi_mcpforge-0.1.0/docs/architecture.md +170 -0
  10. openapi_mcpforge-0.1.0/docs/configuration.md +242 -0
  11. openapi_mcpforge-0.1.0/docs/security.md +168 -0
  12. openapi_mcpforge-0.1.0/docs/supported-specifications.md +198 -0
  13. openapi_mcpforge-0.1.0/examples/basic/.env.example +4 -0
  14. openapi_mcpforge-0.1.0/examples/basic/mcpforge.yaml +43 -0
  15. openapi_mcpforge-0.1.0/examples/openapi/petstore.yaml +148 -0
  16. openapi_mcpforge-0.1.0/live_api.yaml +20 -0
  17. openapi_mcpforge-0.1.0/live_api_2.yaml +14 -0
  18. openapi_mcpforge-0.1.0/live_config.yaml +2 -0
  19. openapi_mcpforge-0.1.0/live_config_2.yaml +3 -0
  20. openapi_mcpforge-0.1.0/local_test.yaml +43 -0
  21. openapi_mcpforge-0.1.0/petstore_config.yaml +2 -0
  22. openapi_mcpforge-0.1.0/pyproject.toml +72 -0
  23. openapi_mcpforge-0.1.0/src/mcpforge/__init__.py +8 -0
  24. openapi_mcpforge-0.1.0/src/mcpforge/__main__.py +6 -0
  25. openapi_mcpforge-0.1.0/src/mcpforge/auth/__init__.py +28 -0
  26. openapi_mcpforge-0.1.0/src/mcpforge/auth/models.py +25 -0
  27. openapi_mcpforge-0.1.0/src/mcpforge/auth/providers.py +72 -0
  28. openapi_mcpforge-0.1.0/src/mcpforge/auth/redaction.py +47 -0
  29. openapi_mcpforge-0.1.0/src/mcpforge/auth/resolver.py +42 -0
  30. openapi_mcpforge-0.1.0/src/mcpforge/cli/__init__.py +1 -0
  31. openapi_mcpforge-0.1.0/src/mcpforge/cli/app.py +45 -0
  32. openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/__init__.py +13 -0
  33. openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/import_spec.py +41 -0
  34. openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/init.py +42 -0
  35. openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/inspect.py +56 -0
  36. openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/run.py +44 -0
  37. openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/serve.py +31 -0
  38. openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/test.py +60 -0
  39. openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/validate.py +41 -0
  40. openapi_mcpforge-0.1.0/src/mcpforge/cli/context.py +14 -0
  41. openapi_mcpforge-0.1.0/src/mcpforge/cli/output.py +31 -0
  42. openapi_mcpforge-0.1.0/src/mcpforge/cli/scaffold.py +71 -0
  43. openapi_mcpforge-0.1.0/src/mcpforge/config/__init__.py +37 -0
  44. openapi_mcpforge-0.1.0/src/mcpforge/config/loader.py +44 -0
  45. openapi_mcpforge-0.1.0/src/mcpforge/config/merger.py +25 -0
  46. openapi_mcpforge-0.1.0/src/mcpforge/config/models.py +182 -0
  47. openapi_mcpforge-0.1.0/src/mcpforge/config/secrets.py +94 -0
  48. openapi_mcpforge-0.1.0/src/mcpforge/domain/__init__.py +37 -0
  49. openapi_mcpforge-0.1.0/src/mcpforge/domain/enums.py +42 -0
  50. openapi_mcpforge-0.1.0/src/mcpforge/domain/errors.py +13 -0
  51. openapi_mcpforge-0.1.0/src/mcpforge/domain/models.py +142 -0
  52. openapi_mcpforge-0.1.0/src/mcpforge/domain/parameters.py +33 -0
  53. openapi_mcpforge-0.1.0/src/mcpforge/domain/schemas.py +6 -0
  54. openapi_mcpforge-0.1.0/src/mcpforge/execution/__init__.py +36 -0
  55. openapi_mcpforge-0.1.0/src/mcpforge/execution/client.py +55 -0
  56. openapi_mcpforge-0.1.0/src/mcpforge/execution/engine.py +199 -0
  57. openapi_mcpforge-0.1.0/src/mcpforge/execution/errors.py +83 -0
  58. openapi_mcpforge-0.1.0/src/mcpforge/execution/limits.py +31 -0
  59. openapi_mcpforge-0.1.0/src/mcpforge/execution/request_builder.py +87 -0
  60. openapi_mcpforge-0.1.0/src/mcpforge/execution/response.py +64 -0
  61. openapi_mcpforge-0.1.0/src/mcpforge/execution/retry.py +69 -0
  62. openapi_mcpforge-0.1.0/src/mcpforge/filtering/__init__.py +7 -0
  63. openapi_mcpforge-0.1.0/src/mcpforge/filtering/evaluator.py +26 -0
  64. openapi_mcpforge-0.1.0/src/mcpforge/filtering/policies.py +44 -0
  65. openapi_mcpforge-0.1.0/src/mcpforge/filtering/selectors.py +31 -0
  66. openapi_mcpforge-0.1.0/src/mcpforge/generation/__init__.py +19 -0
  67. openapi_mcpforge-0.1.0/src/mcpforge/generation/collisions.py +24 -0
  68. openapi_mcpforge-0.1.0/src/mcpforge/generation/descriptions.py +15 -0
  69. openapi_mcpforge-0.1.0/src/mcpforge/generation/input_schema.py +53 -0
  70. openapi_mcpforge-0.1.0/src/mcpforge/generation/models.py +32 -0
  71. openapi_mcpforge-0.1.0/src/mcpforge/generation/naming.py +54 -0
  72. openapi_mcpforge-0.1.0/src/mcpforge/generation/service.py +64 -0
  73. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/__init__.py +26 -0
  74. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/errors.py +23 -0
  75. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/loaders/__init__.py +7 -0
  76. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/loaders/file.py +48 -0
  77. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/loaders/remote.py +83 -0
  78. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/__init__.py +23 -0
  79. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/operation.py +83 -0
  80. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/parameters.py +119 -0
  81. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/references.py +57 -0
  82. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/schemas.py +76 -0
  83. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/__init__.py +8 -0
  84. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/base.py +14 -0
  85. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/manual.py +82 -0
  86. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/openapi.py +87 -0
  87. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/swagger.py +95 -0
  88. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/service.py +84 -0
  89. openapi_mcpforge-0.1.0/src/mcpforge/ingestion/source.py +50 -0
  90. openapi_mcpforge-0.1.0/src/mcpforge/mcp/__init__.py +39 -0
  91. openapi_mcpforge-0.1.0/src/mcpforge/mcp/adapter.py +88 -0
  92. openapi_mcpforge-0.1.0/src/mcpforge/mcp/errors.py +25 -0
  93. openapi_mcpforge-0.1.0/src/mcpforge/mcp/server.py +46 -0
  94. openapi_mcpforge-0.1.0/src/mcpforge/mcp/tools.py +110 -0
  95. openapi_mcpforge-0.1.0/src/mcpforge/mcp/transports.py +51 -0
  96. openapi_mcpforge-0.1.0/src/mcpforge/observability/__init__.py +23 -0
  97. openapi_mcpforge-0.1.0/src/mcpforge/observability/diagnostics.py +45 -0
  98. openapi_mcpforge-0.1.0/src/mcpforge/observability/events.py +58 -0
  99. openapi_mcpforge-0.1.0/src/mcpforge/observability/logging.py +45 -0
  100. openapi_mcpforge-0.1.0/src/mcpforge/runtime/__init__.py +15 -0
  101. openapi_mcpforge-0.1.0/src/mcpforge/runtime/application.py +82 -0
  102. openapi_mcpforge-0.1.0/src/mcpforge/runtime/dependencies.py +77 -0
  103. openapi_mcpforge-0.1.0/src/mcpforge/runtime/lifecycle.py +50 -0
  104. openapi_mcpforge-0.1.0/src/mcpforge/security/__init__.py +40 -0
  105. openapi_mcpforge-0.1.0/src/mcpforge/security/hosts.py +32 -0
  106. openapi_mcpforge-0.1.0/src/mcpforge/security/redaction.py +60 -0
  107. openapi_mcpforge-0.1.0/src/mcpforge/security/safety.py +39 -0
  108. openapi_mcpforge-0.1.0/src/mcpforge/security/ssrf.py +77 -0
  109. openapi_mcpforge-0.1.0/src/mcpforge/security/validation.py +36 -0
  110. openapi_mcpforge-0.1.0/tests/conftest.py +12 -0
  111. openapi_mcpforge-0.1.0/tests/e2e/test_manual_workflow.py +70 -0
  112. openapi_mcpforge-0.1.0/tests/e2e/test_openapi_workflow.py +84 -0
  113. openapi_mcpforge-0.1.0/tests/fixtures/manual/basic.yaml +46 -0
  114. openapi_mcpforge-0.1.0/tests/fixtures/openapi/petstore.yaml +66 -0
  115. openapi_mcpforge-0.1.0/tests/fixtures/responses/error.json +6 -0
  116. openapi_mcpforge-0.1.0/tests/fixtures/responses/success.json +5 -0
  117. openapi_mcpforge-0.1.0/tests/fixtures/swagger/petstore.yaml +56 -0
  118. openapi_mcpforge-0.1.0/tests/integration/cli/test_complete_cli.py +64 -0
  119. openapi_mcpforge-0.1.0/tests/integration/execution/test_http_engine.py +54 -0
  120. openapi_mcpforge-0.1.0/tests/integration/server/test_stdio.py +12 -0
  121. openapi_mcpforge-0.1.0/tests/integration/server/test_streamable_http.py +17 -0
  122. openapi_mcpforge-0.1.0/tests/integration/server/test_tool_execution.py +68 -0
  123. openapi_mcpforge-0.1.0/tests/unit/auth/test_auth_models.py +17 -0
  124. openapi_mcpforge-0.1.0/tests/unit/auth/test_auth_providers.py +26 -0
  125. openapi_mcpforge-0.1.0/tests/unit/auth/test_auth_redaction.py +21 -0
  126. openapi_mcpforge-0.1.0/tests/unit/cli/test_app.py +19 -0
  127. openapi_mcpforge-0.1.0/tests/unit/cli/test_import_spec.py +38 -0
  128. openapi_mcpforge-0.1.0/tests/unit/cli/test_init.py +22 -0
  129. openapi_mcpforge-0.1.0/tests/unit/cli/test_inspect.py +44 -0
  130. openapi_mcpforge-0.1.0/tests/unit/cli/test_run.py +42 -0
  131. openapi_mcpforge-0.1.0/tests/unit/cli/test_serve.py +25 -0
  132. openapi_mcpforge-0.1.0/tests/unit/cli/test_test.py +49 -0
  133. openapi_mcpforge-0.1.0/tests/unit/cli/test_validate.py +45 -0
  134. openapi_mcpforge-0.1.0/tests/unit/config/test_loader.py +59 -0
  135. openapi_mcpforge-0.1.0/tests/unit/config/test_merger.py +26 -0
  136. openapi_mcpforge-0.1.0/tests/unit/config/test_secrets.py +38 -0
  137. openapi_mcpforge-0.1.0/tests/unit/domain/test_models.py +46 -0
  138. openapi_mcpforge-0.1.0/tests/unit/domain/test_schemas.py +49 -0
  139. openapi_mcpforge-0.1.0/tests/unit/execution/test_errors.py +10 -0
  140. openapi_mcpforge-0.1.0/tests/unit/execution/test_limits.py +21 -0
  141. openapi_mcpforge-0.1.0/tests/unit/execution/test_request_builder.py +49 -0
  142. openapi_mcpforge-0.1.0/tests/unit/execution/test_response.py +42 -0
  143. openapi_mcpforge-0.1.0/tests/unit/execution/test_retry.py +32 -0
  144. openapi_mcpforge-0.1.0/tests/unit/filtering/test_evaluator.py +41 -0
  145. openapi_mcpforge-0.1.0/tests/unit/filtering/test_policies.py +26 -0
  146. openapi_mcpforge-0.1.0/tests/unit/generation/test_collisions.py +12 -0
  147. openapi_mcpforge-0.1.0/tests/unit/generation/test_input_schema.py +32 -0
  148. openapi_mcpforge-0.1.0/tests/unit/generation/test_naming.py +31 -0
  149. openapi_mcpforge-0.1.0/tests/unit/ingestion/test_file_loader.py +32 -0
  150. openapi_mcpforge-0.1.0/tests/unit/ingestion/test_manual.py +19 -0
  151. openapi_mcpforge-0.1.0/tests/unit/ingestion/test_normalization.py +62 -0
  152. openapi_mcpforge-0.1.0/tests/unit/ingestion/test_openapi.py +23 -0
  153. openapi_mcpforge-0.1.0/tests/unit/ingestion/test_references.py +41 -0
  154. openapi_mcpforge-0.1.0/tests/unit/ingestion/test_remote_loader.py +56 -0
  155. openapi_mcpforge-0.1.0/tests/unit/ingestion/test_swagger.py +21 -0
  156. openapi_mcpforge-0.1.0/tests/unit/mcp/test_adapter.py +60 -0
  157. openapi_mcpforge-0.1.0/tests/unit/mcp/test_errors.py +31 -0
  158. openapi_mcpforge-0.1.0/tests/unit/mcp/test_tools.py +70 -0
  159. openapi_mcpforge-0.1.0/tests/unit/runtime/test_application.py +74 -0
  160. openapi_mcpforge-0.1.0/tests/unit/runtime/test_lifecycle.py +20 -0
  161. openapi_mcpforge-0.1.0/tests/unit/security/test_hosts.py +18 -0
  162. openapi_mcpforge-0.1.0/tests/unit/security/test_redaction.py +21 -0
  163. openapi_mcpforge-0.1.0/tests/unit/security/test_safety.py +42 -0
  164. openapi_mcpforge-0.1.0/tests/unit/security/test_ssrf.py +28 -0
@@ -0,0 +1,50 @@
1
+ name: CI
2
+
3
+ on:
4
+ push:
5
+ branches:
6
+ - main
7
+ - master
8
+ pull_request:
9
+
10
+ permissions:
11
+ contents: read
12
+
13
+ jobs:
14
+ quality:
15
+ name: Python ${{ matrix.python-version }}
16
+ runs-on: ubuntu-latest
17
+ strategy:
18
+ fail-fast: false
19
+ matrix:
20
+ python-version:
21
+ - "3.11"
22
+ - "3.12"
23
+
24
+ steps:
25
+ - name: Check out repository
26
+ uses: actions/checkout@v4
27
+
28
+ - name: Set up Python
29
+ uses: actions/setup-python@v5
30
+ with:
31
+ python-version: ${{ matrix.python-version }}
32
+ cache: pip
33
+
34
+ - name: Upgrade packaging tools
35
+ run: python -m pip install --upgrade pip
36
+
37
+ - name: Install project and development dependencies
38
+ run: python -m pip install -e ".[dev]"
39
+
40
+ - name: Run Ruff lint
41
+ run: python -m ruff check .
42
+
43
+ - name: Check Ruff formatting
44
+ run: python -m ruff format --check .
45
+
46
+ - name: Run mypy
47
+ run: python -m mypy src
48
+
49
+ - name: Run tests
50
+ run: python -m pytest
@@ -0,0 +1,20 @@
1
+ .venv/
2
+ venv/
3
+ __pycache__/
4
+ *.py[cod]
5
+ .pytest_cache/
6
+ .mypy_cache/
7
+ .ruff_cache/
8
+ .coverage
9
+ htmlcov/
10
+ coverage.xml
11
+ dist/
12
+ build/
13
+ *.egg-info/
14
+ .env
15
+ .env.*
16
+ !.env.example
17
+ .DS_Store
18
+ .vscode/
19
+ .idea/
20
+ *.log
@@ -0,0 +1,18 @@
1
+ repos:
2
+ - repo: https://github.com/astral-sh/ruff-pre-commit
3
+ rev: v0.5.7
4
+ hooks:
5
+ - id: ruff
6
+ args: [--fix]
7
+ - id: ruff-format
8
+
9
+ - repo: https://github.com/pre-commit/mirrors-mypy
10
+ rev: v1.10.0
11
+ hooks:
12
+ - id: mypy
13
+ additional_dependencies:
14
+ - pydantic>=2.7,<3
15
+ - PyYAML>=6,<7
16
+ - types-PyYAML
17
+ - typer>=0.12,<1
18
+ - rich>=13.7,<14
@@ -0,0 +1,41 @@
1
+ # Changelog
2
+
3
+ All notable changes to MCPForge are documented here.
4
+
5
+ The project follows a human-readable changelog format. Release versions and
6
+ dates may change before the first stable release.
7
+
8
+ ## [Unreleased]
9
+
10
+ ### Added
11
+
12
+ - Initial MCPForge package architecture.
13
+ - Pydantic v2 normalized domain models.
14
+ - YAML and JSON project configuration.
15
+ - Environment-backed authentication references.
16
+ - OpenAPI, Swagger, and manual ingestion pipeline.
17
+ - Endpoint filtering and operation safety policies.
18
+ - Deterministic MCP tool generation.
19
+ - Bearer, API-key, Basic, and static-header authentication providers.
20
+ - SSRF and private-network protections.
21
+ - Async HTTP execution engine with retries and response limits.
22
+ - MCP adapter architecture for stdio and streamable HTTP.
23
+ - Typer and Rich CLI foundation.
24
+ - Example configurations and technical documentation.
25
+
26
+ ### Security
27
+
28
+ - Read operations enabled by default.
29
+ - Write and delete operations disabled by default.
30
+ - Secret values excluded from tool metadata.
31
+ - Recursive redaction for diagnostic output.
32
+ - Allowed-host enforcement support.
33
+ - DNS-based private-network validation.
34
+
35
+ ## [0.1.0] - Initial Development Release
36
+
37
+ This release establishes the initial repository structure and implementation
38
+ contracts for the MCPForge project.
39
+
40
+ [Unreleased]: https://github.com/AshishVail/mcpforge/compare/v0.1.0...HEAD
41
+ [0.1.0]: https://github.com/AshishVail/mcpforge/releases/tag/v0.1.0
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Ashish
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,18 @@
1
+ .PHONY: install test lint typecheck format check
2
+
3
+ install:
4
+ python -m pip install -e ".[dev]"
5
+
6
+ test:
7
+ python -m pytest
8
+
9
+ lint:
10
+ python -m ruff check .
11
+
12
+ typecheck:
13
+ python -m mypy src
14
+
15
+ format:
16
+ python -m ruff format .
17
+
18
+ check: lint typecheck test