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.
- openapi_mcpforge-0.1.0/.github/workflows/ci.yml +50 -0
- openapi_mcpforge-0.1.0/.gitignore +20 -0
- openapi_mcpforge-0.1.0/.pre-commit-config.yaml +18 -0
- openapi_mcpforge-0.1.0/CHANGELOG.md +41 -0
- openapi_mcpforge-0.1.0/LICENSE +21 -0
- openapi_mcpforge-0.1.0/Makefile +18 -0
- openapi_mcpforge-0.1.0/PKG-INFO +1566 -0
- openapi_mcpforge-0.1.0/README.md +1537 -0
- openapi_mcpforge-0.1.0/docs/architecture.md +170 -0
- openapi_mcpforge-0.1.0/docs/configuration.md +242 -0
- openapi_mcpforge-0.1.0/docs/security.md +168 -0
- openapi_mcpforge-0.1.0/docs/supported-specifications.md +198 -0
- openapi_mcpforge-0.1.0/examples/basic/.env.example +4 -0
- openapi_mcpforge-0.1.0/examples/basic/mcpforge.yaml +43 -0
- openapi_mcpforge-0.1.0/examples/openapi/petstore.yaml +148 -0
- openapi_mcpforge-0.1.0/live_api.yaml +20 -0
- openapi_mcpforge-0.1.0/live_api_2.yaml +14 -0
- openapi_mcpforge-0.1.0/live_config.yaml +2 -0
- openapi_mcpforge-0.1.0/live_config_2.yaml +3 -0
- openapi_mcpforge-0.1.0/local_test.yaml +43 -0
- openapi_mcpforge-0.1.0/petstore_config.yaml +2 -0
- openapi_mcpforge-0.1.0/pyproject.toml +72 -0
- openapi_mcpforge-0.1.0/src/mcpforge/__init__.py +8 -0
- openapi_mcpforge-0.1.0/src/mcpforge/__main__.py +6 -0
- openapi_mcpforge-0.1.0/src/mcpforge/auth/__init__.py +28 -0
- openapi_mcpforge-0.1.0/src/mcpforge/auth/models.py +25 -0
- openapi_mcpforge-0.1.0/src/mcpforge/auth/providers.py +72 -0
- openapi_mcpforge-0.1.0/src/mcpforge/auth/redaction.py +47 -0
- openapi_mcpforge-0.1.0/src/mcpforge/auth/resolver.py +42 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/__init__.py +1 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/app.py +45 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/__init__.py +13 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/import_spec.py +41 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/init.py +42 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/inspect.py +56 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/run.py +44 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/serve.py +31 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/test.py +60 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/commands/validate.py +41 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/context.py +14 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/output.py +31 -0
- openapi_mcpforge-0.1.0/src/mcpforge/cli/scaffold.py +71 -0
- openapi_mcpforge-0.1.0/src/mcpforge/config/__init__.py +37 -0
- openapi_mcpforge-0.1.0/src/mcpforge/config/loader.py +44 -0
- openapi_mcpforge-0.1.0/src/mcpforge/config/merger.py +25 -0
- openapi_mcpforge-0.1.0/src/mcpforge/config/models.py +182 -0
- openapi_mcpforge-0.1.0/src/mcpforge/config/secrets.py +94 -0
- openapi_mcpforge-0.1.0/src/mcpforge/domain/__init__.py +37 -0
- openapi_mcpforge-0.1.0/src/mcpforge/domain/enums.py +42 -0
- openapi_mcpforge-0.1.0/src/mcpforge/domain/errors.py +13 -0
- openapi_mcpforge-0.1.0/src/mcpforge/domain/models.py +142 -0
- openapi_mcpforge-0.1.0/src/mcpforge/domain/parameters.py +33 -0
- openapi_mcpforge-0.1.0/src/mcpforge/domain/schemas.py +6 -0
- openapi_mcpforge-0.1.0/src/mcpforge/execution/__init__.py +36 -0
- openapi_mcpforge-0.1.0/src/mcpforge/execution/client.py +55 -0
- openapi_mcpforge-0.1.0/src/mcpforge/execution/engine.py +199 -0
- openapi_mcpforge-0.1.0/src/mcpforge/execution/errors.py +83 -0
- openapi_mcpforge-0.1.0/src/mcpforge/execution/limits.py +31 -0
- openapi_mcpforge-0.1.0/src/mcpforge/execution/request_builder.py +87 -0
- openapi_mcpforge-0.1.0/src/mcpforge/execution/response.py +64 -0
- openapi_mcpforge-0.1.0/src/mcpforge/execution/retry.py +69 -0
- openapi_mcpforge-0.1.0/src/mcpforge/filtering/__init__.py +7 -0
- openapi_mcpforge-0.1.0/src/mcpforge/filtering/evaluator.py +26 -0
- openapi_mcpforge-0.1.0/src/mcpforge/filtering/policies.py +44 -0
- openapi_mcpforge-0.1.0/src/mcpforge/filtering/selectors.py +31 -0
- openapi_mcpforge-0.1.0/src/mcpforge/generation/__init__.py +19 -0
- openapi_mcpforge-0.1.0/src/mcpforge/generation/collisions.py +24 -0
- openapi_mcpforge-0.1.0/src/mcpforge/generation/descriptions.py +15 -0
- openapi_mcpforge-0.1.0/src/mcpforge/generation/input_schema.py +53 -0
- openapi_mcpforge-0.1.0/src/mcpforge/generation/models.py +32 -0
- openapi_mcpforge-0.1.0/src/mcpforge/generation/naming.py +54 -0
- openapi_mcpforge-0.1.0/src/mcpforge/generation/service.py +64 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/__init__.py +26 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/errors.py +23 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/loaders/__init__.py +7 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/loaders/file.py +48 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/loaders/remote.py +83 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/__init__.py +23 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/operation.py +83 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/parameters.py +119 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/references.py +57 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/normalization/schemas.py +76 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/__init__.py +8 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/base.py +14 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/manual.py +82 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/openapi.py +87 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/parsers/swagger.py +95 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/service.py +84 -0
- openapi_mcpforge-0.1.0/src/mcpforge/ingestion/source.py +50 -0
- openapi_mcpforge-0.1.0/src/mcpforge/mcp/__init__.py +39 -0
- openapi_mcpforge-0.1.0/src/mcpforge/mcp/adapter.py +88 -0
- openapi_mcpforge-0.1.0/src/mcpforge/mcp/errors.py +25 -0
- openapi_mcpforge-0.1.0/src/mcpforge/mcp/server.py +46 -0
- openapi_mcpforge-0.1.0/src/mcpforge/mcp/tools.py +110 -0
- openapi_mcpforge-0.1.0/src/mcpforge/mcp/transports.py +51 -0
- openapi_mcpforge-0.1.0/src/mcpforge/observability/__init__.py +23 -0
- openapi_mcpforge-0.1.0/src/mcpforge/observability/diagnostics.py +45 -0
- openapi_mcpforge-0.1.0/src/mcpforge/observability/events.py +58 -0
- openapi_mcpforge-0.1.0/src/mcpforge/observability/logging.py +45 -0
- openapi_mcpforge-0.1.0/src/mcpforge/runtime/__init__.py +15 -0
- openapi_mcpforge-0.1.0/src/mcpforge/runtime/application.py +82 -0
- openapi_mcpforge-0.1.0/src/mcpforge/runtime/dependencies.py +77 -0
- openapi_mcpforge-0.1.0/src/mcpforge/runtime/lifecycle.py +50 -0
- openapi_mcpforge-0.1.0/src/mcpforge/security/__init__.py +40 -0
- openapi_mcpforge-0.1.0/src/mcpforge/security/hosts.py +32 -0
- openapi_mcpforge-0.1.0/src/mcpforge/security/redaction.py +60 -0
- openapi_mcpforge-0.1.0/src/mcpforge/security/safety.py +39 -0
- openapi_mcpforge-0.1.0/src/mcpforge/security/ssrf.py +77 -0
- openapi_mcpforge-0.1.0/src/mcpforge/security/validation.py +36 -0
- openapi_mcpforge-0.1.0/tests/conftest.py +12 -0
- openapi_mcpforge-0.1.0/tests/e2e/test_manual_workflow.py +70 -0
- openapi_mcpforge-0.1.0/tests/e2e/test_openapi_workflow.py +84 -0
- openapi_mcpforge-0.1.0/tests/fixtures/manual/basic.yaml +46 -0
- openapi_mcpforge-0.1.0/tests/fixtures/openapi/petstore.yaml +66 -0
- openapi_mcpforge-0.1.0/tests/fixtures/responses/error.json +6 -0
- openapi_mcpforge-0.1.0/tests/fixtures/responses/success.json +5 -0
- openapi_mcpforge-0.1.0/tests/fixtures/swagger/petstore.yaml +56 -0
- openapi_mcpforge-0.1.0/tests/integration/cli/test_complete_cli.py +64 -0
- openapi_mcpforge-0.1.0/tests/integration/execution/test_http_engine.py +54 -0
- openapi_mcpforge-0.1.0/tests/integration/server/test_stdio.py +12 -0
- openapi_mcpforge-0.1.0/tests/integration/server/test_streamable_http.py +17 -0
- openapi_mcpforge-0.1.0/tests/integration/server/test_tool_execution.py +68 -0
- openapi_mcpforge-0.1.0/tests/unit/auth/test_auth_models.py +17 -0
- openapi_mcpforge-0.1.0/tests/unit/auth/test_auth_providers.py +26 -0
- openapi_mcpforge-0.1.0/tests/unit/auth/test_auth_redaction.py +21 -0
- openapi_mcpforge-0.1.0/tests/unit/cli/test_app.py +19 -0
- openapi_mcpforge-0.1.0/tests/unit/cli/test_import_spec.py +38 -0
- openapi_mcpforge-0.1.0/tests/unit/cli/test_init.py +22 -0
- openapi_mcpforge-0.1.0/tests/unit/cli/test_inspect.py +44 -0
- openapi_mcpforge-0.1.0/tests/unit/cli/test_run.py +42 -0
- openapi_mcpforge-0.1.0/tests/unit/cli/test_serve.py +25 -0
- openapi_mcpforge-0.1.0/tests/unit/cli/test_test.py +49 -0
- openapi_mcpforge-0.1.0/tests/unit/cli/test_validate.py +45 -0
- openapi_mcpforge-0.1.0/tests/unit/config/test_loader.py +59 -0
- openapi_mcpforge-0.1.0/tests/unit/config/test_merger.py +26 -0
- openapi_mcpforge-0.1.0/tests/unit/config/test_secrets.py +38 -0
- openapi_mcpforge-0.1.0/tests/unit/domain/test_models.py +46 -0
- openapi_mcpforge-0.1.0/tests/unit/domain/test_schemas.py +49 -0
- openapi_mcpforge-0.1.0/tests/unit/execution/test_errors.py +10 -0
- openapi_mcpforge-0.1.0/tests/unit/execution/test_limits.py +21 -0
- openapi_mcpforge-0.1.0/tests/unit/execution/test_request_builder.py +49 -0
- openapi_mcpforge-0.1.0/tests/unit/execution/test_response.py +42 -0
- openapi_mcpforge-0.1.0/tests/unit/execution/test_retry.py +32 -0
- openapi_mcpforge-0.1.0/tests/unit/filtering/test_evaluator.py +41 -0
- openapi_mcpforge-0.1.0/tests/unit/filtering/test_policies.py +26 -0
- openapi_mcpforge-0.1.0/tests/unit/generation/test_collisions.py +12 -0
- openapi_mcpforge-0.1.0/tests/unit/generation/test_input_schema.py +32 -0
- openapi_mcpforge-0.1.0/tests/unit/generation/test_naming.py +31 -0
- openapi_mcpforge-0.1.0/tests/unit/ingestion/test_file_loader.py +32 -0
- openapi_mcpforge-0.1.0/tests/unit/ingestion/test_manual.py +19 -0
- openapi_mcpforge-0.1.0/tests/unit/ingestion/test_normalization.py +62 -0
- openapi_mcpforge-0.1.0/tests/unit/ingestion/test_openapi.py +23 -0
- openapi_mcpforge-0.1.0/tests/unit/ingestion/test_references.py +41 -0
- openapi_mcpforge-0.1.0/tests/unit/ingestion/test_remote_loader.py +56 -0
- openapi_mcpforge-0.1.0/tests/unit/ingestion/test_swagger.py +21 -0
- openapi_mcpforge-0.1.0/tests/unit/mcp/test_adapter.py +60 -0
- openapi_mcpforge-0.1.0/tests/unit/mcp/test_errors.py +31 -0
- openapi_mcpforge-0.1.0/tests/unit/mcp/test_tools.py +70 -0
- openapi_mcpforge-0.1.0/tests/unit/runtime/test_application.py +74 -0
- openapi_mcpforge-0.1.0/tests/unit/runtime/test_lifecycle.py +20 -0
- openapi_mcpforge-0.1.0/tests/unit/security/test_hosts.py +18 -0
- openapi_mcpforge-0.1.0/tests/unit/security/test_redaction.py +21 -0
- openapi_mcpforge-0.1.0/tests/unit/security/test_safety.py +42 -0
- 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,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
|