fme-mcp 1.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 (106) hide show
  1. fme_mcp-1.1.0/.env.example +43 -0
  2. fme_mcp-1.1.0/.github/CODEOWNERS +3 -0
  3. fme_mcp-1.1.0/.github/FUNDING.yml +2 -0
  4. fme_mcp-1.1.0/.github/ISSUE_TEMPLATE/bug_report.yml +36 -0
  5. fme_mcp-1.1.0/.github/ISSUE_TEMPLATE/feature_request.yml +25 -0
  6. fme_mcp-1.1.0/.github/ISSUE_TEMPLATE/security_report.yml +15 -0
  7. fme_mcp-1.1.0/.github/PULL_REQUEST_TEMPLATE.md +23 -0
  8. fme_mcp-1.1.0/.github/workflows/ci.yml +71 -0
  9. fme_mcp-1.1.0/.github/workflows/docs.yml +33 -0
  10. fme_mcp-1.1.0/.github/workflows/publish.yml +36 -0
  11. fme_mcp-1.1.0/.github/workflows/release-binaries.yml +80 -0
  12. fme_mcp-1.1.0/.github/workflows/release.yml +77 -0
  13. fme_mcp-1.1.0/.github/workflows/security.yml +45 -0
  14. fme_mcp-1.1.0/.gitignore +83 -0
  15. fme_mcp-1.1.0/.mcp.json +10 -0
  16. fme_mcp-1.1.0/CHANGELOG.md +43 -0
  17. fme_mcp-1.1.0/CODE_OF_CONDUCT.md +48 -0
  18. fme_mcp-1.1.0/CONTRIBUTING.md +75 -0
  19. fme_mcp-1.1.0/Dockerfile +61 -0
  20. fme_mcp-1.1.0/GOVERNANCE.md +18 -0
  21. fme_mcp-1.1.0/LICENSE +191 -0
  22. fme_mcp-1.1.0/PKG-INFO +337 -0
  23. fme_mcp-1.1.0/README.md +285 -0
  24. fme_mcp-1.1.0/ROADMAP.md +29 -0
  25. fme_mcp-1.1.0/SECURITY.md +44 -0
  26. fme_mcp-1.1.0/SUPPORT.md +15 -0
  27. fme_mcp-1.1.0/docker-compose.yml +27 -0
  28. fme_mcp-1.1.0/docs/assets/fme_hub_logo_200x200.png +0 -0
  29. fme_mcp-1.1.0/docs/assets/logo.jpg +0 -0
  30. fme_mcp-1.1.0/docs/assets/logo.png +0 -0
  31. fme_mcp-1.1.0/docs/authentication.md +47 -0
  32. fme_mcp-1.1.0/docs/code-of-conduct.md +29 -0
  33. fme_mcp-1.1.0/docs/configuration.md +17 -0
  34. fme_mcp-1.1.0/docs/contributing.md +37 -0
  35. fme_mcp-1.1.0/docs/deployment.md +26 -0
  36. fme_mcp-1.1.0/docs/desktop-integration.md +43 -0
  37. fme_mcp-1.1.0/docs/docker.md +78 -0
  38. fme_mcp-1.1.0/docs/fme-2026-parity.md +25 -0
  39. fme_mcp-1.1.0/docs/fme-compatibility.md +33 -0
  40. fme_mcp-1.1.0/docs/index.md +30 -0
  41. fme_mcp-1.1.0/docs/installation.md +223 -0
  42. fme_mcp-1.1.0/docs/mcp-clients.md +99 -0
  43. fme_mcp-1.1.0/docs/observability.md +50 -0
  44. fme_mcp-1.1.0/docs/roadmap.md +39 -0
  45. fme_mcp-1.1.0/docs/security.md +33 -0
  46. fme_mcp-1.1.0/docs/tools.md +149 -0
  47. fme_mcp-1.1.0/examples/antigravity/antigravity_config.json +18 -0
  48. fme_mcp-1.1.0/examples/claude-desktop/claude_desktop_config.json +17 -0
  49. fme_mcp-1.1.0/examples/curl/call_tool.sh +15 -0
  50. fme_mcp-1.1.0/examples/cursor/mcp.json +13 -0
  51. fme_mcp-1.1.0/examples/fme-workbench/fme_startup_hook.py +72 -0
  52. fme_mcp-1.1.0/examples/fme-workbench/shutdown_script.py +46 -0
  53. fme_mcp-1.1.0/examples/fme-workbench/startup_script.py +34 -0
  54. fme_mcp-1.1.0/examples/python-client/client_example.py +26 -0
  55. fme_mcp-1.1.0/examples/workbench/MCPAgentBridge_Demo.fmw +141 -0
  56. fme_mcp-1.1.0/glama.json +7 -0
  57. fme_mcp-1.1.0/mkdocs.yml +67 -0
  58. fme_mcp-1.1.0/pyproject.toml +105 -0
  59. fme_mcp-1.1.0/scripts/build_demo_workspace.py +171 -0
  60. fme_mcp-1.1.0/scripts/build_fme_transformer.py +242 -0
  61. fme_mcp-1.1.0/scripts/build_standalone.py +339 -0
  62. fme_mcp-1.1.0/scripts/install.ps1 +683 -0
  63. fme_mcp-1.1.0/scripts/install.sh +445 -0
  64. fme_mcp-1.1.0/skill/README.md +30 -0
  65. fme_mcp-1.1.0/skill/fme-spatial-engineer/SKILL.md +117 -0
  66. fme_mcp-1.1.0/skill/logo.png +0 -0
  67. fme_mcp-1.1.0/skill/logo_3d.jpg +0 -0
  68. fme_mcp-1.1.0/smithery.yaml +32 -0
  69. fme_mcp-1.1.0/src/fme_mcp/__init__.py +12 -0
  70. fme_mcp-1.1.0/src/fme_mcp/__main__.py +8 -0
  71. fme_mcp-1.1.0/src/fme_mcp/cli/main.py +156 -0
  72. fme_mcp-1.1.0/src/fme_mcp/core/config.py +84 -0
  73. fme_mcp-1.1.0/src/fme_mcp/core/errors.py +80 -0
  74. fme_mcp-1.1.0/src/fme_mcp/core/logging.py +35 -0
  75. fme_mcp-1.1.0/src/fme_mcp/core/schema.py +35 -0
  76. fme_mcp-1.1.0/src/fme_mcp/fme/compatibility_layer.py +55 -0
  77. fme_mcp-1.1.0/src/fme_mcp/fme/fme_bridge.py +165 -0
  78. fme_mcp-1.1.0/src/fme_mcp/fme/fme_flow_client.py +133 -0
  79. fme_mcp-1.1.0/src/fme_mcp/fme/fme_form_client.py +665 -0
  80. fme_mcp-1.1.0/src/fme_mcp/fme/parameter_mapper.py +40 -0
  81. fme_mcp-1.1.0/src/fme_mcp/fme/transformer_bridge.py +143 -0
  82. fme_mcp-1.1.0/src/fme_mcp/security/audit_log.py +44 -0
  83. fme_mcp-1.1.0/src/fme_mcp/security/command_guard.py +57 -0
  84. fme_mcp-1.1.0/src/fme_mcp/security/path_guard.py +64 -0
  85. fme_mcp-1.1.0/src/fme_mcp/security/rbac.py +98 -0
  86. fme_mcp-1.1.0/src/fme_mcp/security/redaction.py +50 -0
  87. fme_mcp-1.1.0/src/fme_mcp/security/ssrf_guard.py +67 -0
  88. fme_mcp-1.1.0/src/fme_mcp/server/mcp_server.py +408 -0
  89. fme_mcp-1.1.0/src/fme_mcp/tools/ai/ai_tools.py +104 -0
  90. fme_mcp-1.1.0/src/fme_mcp/tools/catalog/catalog_tools.py +69 -0
  91. fme_mcp-1.1.0/src/fme_mcp/tools/datasets/dataset_tools.py +105 -0
  92. fme_mcp-1.1.0/src/fme_mcp/tools/governance/governance_tools.py +68 -0
  93. fme_mcp-1.1.0/src/fme_mcp/tools/mcp_federation/federation_tools.py +47 -0
  94. fme_mcp-1.1.0/src/fme_mcp/tools/orchestration/workflow_tools.py +74 -0
  95. fme_mcp-1.1.0/src/fme_mcp/tools/quality/quality_tools.py +78 -0
  96. fme_mcp-1.1.0/src/fme_mcp/tools/spatial/spatial_tools.py +912 -0
  97. fme_mcp-1.1.0/src/fme_mcp/tools/utilities/util_tools.py +86 -0
  98. fme_mcp-1.1.0/src/fme_mcp/tools/workspaces/workspace_tools.py +1186 -0
  99. fme_mcp-1.1.0/tests/integration/test_server_mcp.py +57 -0
  100. fme_mcp-1.1.0/tests/unit/test_enhanced_features.py +546 -0
  101. fme_mcp-1.1.0/tests/unit/test_fme_desktop.py +169 -0
  102. fme_mcp-1.1.0/tests/unit/test_security.py +99 -0
  103. fme_mcp-1.1.0/tests/unit/test_tools.py +99 -0
  104. fme_mcp-1.1.0/tests/unit/test_transformer_bridge.py +66 -0
  105. fme_mcp-1.1.0/transformers/MCPAgentBridge.fmx +104 -0
  106. fme_mcp-1.1.0/uv.lock +3522 -0
@@ -0,0 +1,43 @@
1
+ # ==============================================================================
2
+ # FME-MCP ENVIRONMENT CONFIGURATION
3
+ # ==============================================================================
4
+
5
+ # Server Configuration
6
+ FME_MCP_HOST=0.0.0.0
7
+ FME_MCP_PORT=8000
8
+ FME_MCP_TRANSPORT=stdio
9
+ FME_MCP_LOG_LEVEL=INFO
10
+ FME_MCP_ENVIRONMENT=production
11
+
12
+ # Security & Authentication
13
+ FME_MCP_AUTH_MODE=api_key
14
+ FME_MCP_API_KEY=change-me-to-a-secure-random-token-in-production
15
+ FME_MCP_OAUTH_CLIENT_ID=
16
+ FME_MCP_OAUTH_CLIENT_SECRET=
17
+ FME_MCP_OAUTH_TOKEN_URL=
18
+ FME_MCP_ENCRYPTION_KEY=
19
+
20
+ # File System Security & Sandboxing (PathGuard)
21
+ # Optional: Semicolon or comma-separated list of authorised base paths.
22
+ # Defaults automatically to user home directory, current directory, and FME installation.
23
+ # FME_MCP_ALLOWED_DIRS=C:\Workspaces;D:\GIS_Data;/opt/fme_data
24
+
25
+ # Network Security (SSRF Guard)
26
+ # Comma-separated list of allowed remote hostnames/domains for federation
27
+ FME_ALLOWED_OUTBOUND_DOMAINS=fme-flow.internal,safe.com,api.github.com
28
+
29
+ # FME Form (Local Desktop) Settings
30
+ FME_FORM_ENABLED=true
31
+ FME_DIR=C:\Program Files\FME
32
+ FME_TIMEOUT_SECONDS=600
33
+
34
+ # FME Flow (Remote Enterprise Cluster) Settings
35
+ FME_FLOW_ENABLED=false
36
+ FME_FLOW_URL=https://fme-flow.your-organisation.com
37
+ FME_FLOW_TOKEN=your-fme-flow-api-token
38
+ FME_FLOW_VERIFY_SSL=true
39
+
40
+ # Observability
41
+ FME_MCP_TELEMETRY_ENABLED=true
42
+ FME_MCP_PROMETHEUS_METRICS=true
43
+
@@ -0,0 +1,3 @@
1
+ # Global Codeowners
2
+ * @mwjouini
3
+
@@ -0,0 +1,2 @@
1
+ github: [mwjouini]
2
+
@@ -0,0 +1,36 @@
1
+ name: Bug Report
2
+ description: Create a report to help us improve FME MCP
3
+ title: "[BUG]: "
4
+ labels: ["bug", "triage"]
5
+ body:
6
+ - type: markdown
7
+ attributes:
8
+ value: |
9
+ Thank you for reporting a bug. Please ensure you are not reporting a security vulnerability here (use GitHub Private Vulnerability Reporting instead).
10
+ - type: input
11
+ id: version
12
+ attributes:
13
+ label: FME MCP Version
14
+ placeholder: "1.0.0"
15
+ validations:
16
+ required: true
17
+ - type: input
18
+ id: fme_version
19
+ attributes:
20
+ label: FME Form / Flow Version
21
+ placeholder: "e.g. FME Form 2024.1 (Build 24610) or FME Flow 2023.2"
22
+ validations:
23
+ required: true
24
+ - type: textarea
25
+ id: description
26
+ attributes:
27
+ label: Description & Steps to Reproduce
28
+ placeholder: "1. Call tool 'fme_run_workspace' with...\n2. Observe error..."
29
+ validations:
30
+ required: true
31
+ - type: textarea
32
+ id: logs
33
+ attributes:
34
+ label: Relevant Logs
35
+ render: shell
36
+
@@ -0,0 +1,25 @@
1
+ name: Feature Request
2
+ description: Propose a new feature, MCP tool, or transformer integration
3
+ title: "[FEAT]: "
4
+ labels: ["enhancement"]
5
+ body:
6
+ - type: input
7
+ id: feature_summary
8
+ attributes:
9
+ label: Feature Summary
10
+ placeholder: "Add support for GeoTIFF Cloud-Optimised pyramids..."
11
+ validations:
12
+ required: true
13
+ - type: textarea
14
+ id: use_case
15
+ attributes:
16
+ label: Use Case & Motivation
17
+ placeholder: "Explain the geospatial data problem this solves."
18
+ validations:
19
+ required: true
20
+ - type: textarea
21
+ id: proposed_solution
22
+ attributes:
23
+ label: Proposed Solution or Tool Signature
24
+ placeholder: "tool: gis_export_cog(input_raster, output_path, overview_levels)"
25
+
@@ -0,0 +1,15 @@
1
+ name: Security Vulnerability Report
2
+ description: Report a suspected security issue privately
3
+ title: "[SECURITY]: "
4
+ labels: ["security"]
5
+ body:
6
+ - type: markdown
7
+ attributes:
8
+ value: |
9
+ CRITICAL: If this is an exploitable security vulnerability, please email `mohamed.wael.jouini@gmail.com` directly rather than creating a public issue.
10
+ - type: textarea
11
+ id: details
12
+ attributes:
13
+ label: General Non-Sensitive Details
14
+ placeholder: "Indicate component and impact without disclosing exploit payloads."
15
+
@@ -0,0 +1,23 @@
1
+ ## Description
2
+
3
+ Please include a summary of the change, relevant motivation, and context.
4
+
5
+ Fixes # (issue)
6
+
7
+ ## Type of Change
8
+
9
+ - [ ] Bug fix (non-breaking change which fixes an issue)
10
+ - [ ] New feature / MCP tool
11
+ - [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
12
+ - [ ] Security remediation / vulnerability fix
13
+ - [ ] Documentation update
14
+
15
+ ## Checklist
16
+
17
+ - [ ] My code adheres to the style guidelines of this project.
18
+ - [ ] I have performed a self-review of my own code.
19
+ - [ ] I have commented my code, particularly in hard-to-understand areas.
20
+ - [ ] I have added tests that prove my fix is effective or that my feature works.
21
+ - [ ] New and existing unit and security tests pass locally.
22
+ - [ ] Any dependent changes have been merged and published in downstream modules.
23
+
@@ -0,0 +1,71 @@
1
+ name: CI
2
+
3
+ on:
4
+ push:
5
+ branches: [main]
6
+ pull_request:
7
+ branches: [main]
8
+
9
+ permissions:
10
+ contents: read
11
+
12
+ jobs:
13
+ lint-and-typecheck:
14
+ name: Lint & Typecheck
15
+ runs-on: ubuntu-latest
16
+ steps:
17
+ - name: Checkout Code
18
+ uses: actions/checkout@v4
19
+
20
+ - name: Set up Python
21
+ uses: actions/setup-python@v5
22
+ with:
23
+ python-version: "3.11"
24
+ cache: "pip"
25
+
26
+ - name: Install Dependencies
27
+ run: |
28
+ python -m pip install --upgrade pip
29
+ pip install ruff mypy
30
+ pip install -e ".[dev]"
31
+
32
+ - name: Run Ruff Linting
33
+ run: ruff check .
34
+
35
+ - name: Run Ruff Formatting Check
36
+ run: ruff format --check .
37
+
38
+ - name: Run MyPy Static Analysis
39
+ run: mypy src/fme_mcp
40
+
41
+ unit-tests:
42
+ name: Unit & Security Tests
43
+ runs-on: ${{ matrix.os }}
44
+ strategy:
45
+ matrix:
46
+ os: [ubuntu-latest, windows-latest]
47
+ python-version: ["3.10", "3.11", "3.12"]
48
+ steps:
49
+ - name: Checkout Code
50
+ uses: actions/checkout@v4
51
+
52
+ - name: Set up Python
53
+ uses: actions/setup-python@v5
54
+ with:
55
+ python-version: ${{ matrix.python-version }}
56
+ cache: "pip"
57
+
58
+ - name: Install Package & Test Dependencies
59
+ run: |
60
+ python -m pip install --upgrade pip
61
+ pip install -e ".[dev]"
62
+
63
+ - name: Run Pytest Suite
64
+ run: pytest tests/ -v --cov=fme_mcp --cov-report=xml
65
+
66
+ - name: Upload Coverage Artifact
67
+ uses: actions/upload-artifact@v4
68
+ with:
69
+ name: coverage-${{ matrix.os }}-py${{ matrix.python-version }}
70
+ path: coverage.xml
71
+
@@ -0,0 +1,33 @@
1
+ name: Docs
2
+
3
+ on:
4
+ push:
5
+ branches: [main]
6
+ workflow_dispatch:
7
+
8
+ permissions:
9
+ contents: write
10
+
11
+ jobs:
12
+ deploy-docs:
13
+ name: Build & Deploy Documentation
14
+ runs-on: ubuntu-latest
15
+ steps:
16
+ - name: Checkout Code
17
+ uses: actions/checkout@v4
18
+
19
+ - name: Set up Python
20
+ uses: actions/setup-python@v5
21
+ with:
22
+ python-version: "3.11"
23
+
24
+ - name: Install MkDocs Dependencies
25
+ run: |
26
+ python -m pip install --upgrade pip
27
+ pip install mkdocs-material mkdocstrings[python]
28
+
29
+ - name: Deploy to GitHub Pages
30
+ run: mkdocs gh-deploy --force
31
+ env:
32
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
33
+
@@ -0,0 +1,36 @@
1
+ name: Publish to PyPI
2
+
3
+ on:
4
+ release:
5
+ types: [published]
6
+ workflow_dispatch:
7
+
8
+ jobs:
9
+ pypi-publish:
10
+ name: Upload Release to PyPI
11
+ runs-on: ubuntu-latest
12
+ permissions:
13
+ id-token: write
14
+ contents: read
15
+ steps:
16
+ - name: Checkout Code
17
+ uses: actions/checkout@v4
18
+
19
+ - name: Set up Python
20
+ uses: actions/setup-python@v5
21
+ with:
22
+ python-version: "3.11"
23
+
24
+ - name: Install Build Dependencies
25
+ run: |
26
+ python -m pip install --upgrade pip
27
+ pip install build hatchling
28
+
29
+ - name: Build Packages
30
+ run: python -m build
31
+
32
+ - name: Publish Package to PyPI
33
+ uses: pypa/gh-action-pypi-publish@release/v1
34
+ with:
35
+ password: ${{ secrets.PYPI_API_TOKEN }}
36
+ skip-existing: true
@@ -0,0 +1,80 @@
1
+ name: FME MCP - Build & Release Standalone Binaries
2
+
3
+ on:
4
+ release:
5
+ types: [published]
6
+ push:
7
+ tags:
8
+ - "v*.*.*"
9
+ workflow_dispatch:
10
+
11
+ permissions:
12
+ contents: write
13
+
14
+ jobs:
15
+ build-binaries:
16
+ name: Build FME MCP Standalone (${{ matrix.os }} - ${{ matrix.arch }})
17
+ runs-on: ${{ matrix.os }}
18
+ strategy:
19
+ fail-fast: false
20
+ matrix:
21
+ include:
22
+ - os: windows-latest
23
+ arch: x64
24
+ binary_name: fme-mcp.exe
25
+ platform_alias: fme-mcp-windows-x64.exe
26
+ - os: ubuntu-latest
27
+ arch: x64
28
+ binary_name: fme-mcp
29
+ platform_alias: fme-mcp-linux-x64
30
+
31
+ steps:
32
+ - name: Checkout Repository
33
+ uses: actions/checkout@v4
34
+
35
+ - name: Set up Python
36
+ uses: actions/setup-python@v5
37
+ with:
38
+ python-version: "3.11"
39
+ cache: "pip"
40
+
41
+ - name: Install Dependencies
42
+ run: |
43
+ python -m pip install --upgrade pip
44
+ pip install -e .
45
+ pip install pyinstaller>=6.0.0 shapely
46
+
47
+ - name: Build FME MCP Standalone Binary with PyInstaller
48
+ run: |
49
+ python scripts/build_standalone.py --clean
50
+
51
+ - name: Smoke Test Standalone Binary (Windows)
52
+ if: runner.os == 'Windows'
53
+ run: |
54
+ .\dist\fme-mcp.exe version
55
+ .\dist\fme-mcp.exe doctor
56
+
57
+ - name: Smoke Test Standalone Binary (Linux)
58
+ if: runner.os == 'Linux'
59
+ run: |
60
+ chmod +x ./dist/fme-mcp
61
+ ./dist/fme-mcp version
62
+ ./dist/fme-mcp doctor
63
+
64
+ - name: Upload FME MCP Build Artifacts
65
+ uses: actions/upload-artifact@v4
66
+ with:
67
+ name: ${{ matrix.binary_name }}
68
+ path: |
69
+ dist/${{ matrix.binary_name }}*
70
+ if-no-files-found: error
71
+
72
+ - name: Attach FME MCP Binaries to GitHub Release
73
+ uses: softprops/action-gh-release@v2
74
+ if: github.event_name == 'release' || startsWith(github.ref, 'refs/tags/')
75
+ with:
76
+ files: |
77
+ dist/${{ matrix.binary_name }}*
78
+ fail_on_unmatched_files: false
79
+ env:
80
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -0,0 +1,77 @@
1
+ name: Release
2
+
3
+ on:
4
+ push:
5
+ tags:
6
+ - "v*.*.*"
7
+
8
+ permissions:
9
+ contents: write
10
+ packages: write
11
+ id-token: write
12
+
13
+ jobs:
14
+ build-and-release:
15
+ name: Build Distribution & GitHub Release
16
+ runs-on: ubuntu-latest
17
+ steps:
18
+ - name: Checkout Code
19
+ uses: actions/checkout@v4
20
+
21
+ - name: Set up Python
22
+ uses: actions/setup-python@v5
23
+ with:
24
+ python-version: "3.11"
25
+
26
+ - name: Install Build Tools
27
+ run: |
28
+ python -m pip install --upgrade pip
29
+ pip install build hatchling
30
+
31
+ - name: Build Wheel & Source Distribution
32
+ run: python -m build
33
+
34
+ - name: Create GitHub Release
35
+ uses: softprops/action-gh-release@v2
36
+ with:
37
+ files: dist/*
38
+ generate_release_notes: true
39
+ env:
40
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
41
+
42
+ docker-build:
43
+ name: Build & Push GHCR Container Image
44
+ runs-on: ubuntu-latest
45
+ steps:
46
+ - name: Checkout Code
47
+ uses: actions/checkout@v4
48
+
49
+ - name: Set up Docker Buildx
50
+ uses: docker/setup-buildx-action@v3
51
+
52
+ - name: Log in to GitHub Container Registry
53
+ uses: docker/login-action@v3
54
+ with:
55
+ registry: ghcr.io
56
+ username: ${{ github.actor }}
57
+ password: ${{ secrets.GITHUB_TOKEN }}
58
+
59
+ - name: Extract Docker metadata
60
+ id: meta
61
+ uses: docker/metadata-action@v5
62
+ with:
63
+ images: ghcr.io/${{ github.repository }}
64
+ tags: |
65
+ type=semver,pattern={{version}}
66
+ type=raw,value=latest
67
+
68
+ - name: Build and Push Container
69
+ uses: docker/build-push-action@v5
70
+ with:
71
+ context: .
72
+ push: true
73
+ tags: ${{ steps.meta.outputs.tags }}
74
+ labels: ${{ steps.meta.outputs.labels }}
75
+ cache-from: type=gha
76
+ cache-to: type=gha,mode=max
77
+
@@ -0,0 +1,45 @@
1
+ name: Security Audit
2
+
3
+ on:
4
+ push:
5
+ branches: [main]
6
+ pull_request:
7
+ branches: [main]
8
+ schedule:
9
+ - cron: "0 4 * * 1" # Every Monday at 04:00 UTC
10
+
11
+ permissions:
12
+ contents: read
13
+
14
+ jobs:
15
+ security-scans:
16
+ name: Security Scans (Bandit, Gitleaks, Pip-Audit)
17
+ runs-on: ubuntu-latest
18
+ steps:
19
+ - name: Checkout Code
20
+ uses: actions/checkout@v4
21
+ with:
22
+ fetch-depth: 0
23
+
24
+ - name: Set up Python
25
+ uses: actions/setup-python@v5
26
+ with:
27
+ python-version: "3.11"
28
+
29
+ - name: Install Security Tools
30
+ run: |
31
+ python -m pip install --upgrade pip
32
+ pip install bandit pip-audit
33
+
34
+ - name: Run Bandit SAST
35
+ run: bandit -r src/fme_mcp -ll -x tests
36
+
37
+ - name: Audit Dependencies for Known CVEs
38
+ run: pip-audit || true
39
+
40
+ - name: Run Gitleaks Secret Scanner
41
+ uses: gitleaks/gitleaks-action@v2
42
+ env:
43
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
44
+ continue-on-error: true
45
+
@@ -0,0 +1,83 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+ *.pyd
9
+
10
+ # Distribution / packaging
11
+ .Python
12
+ build/
13
+ develop-eggs/
14
+ dist/
15
+ downloads/
16
+ eggs/
17
+ .eggs/
18
+ lib/
19
+ lib64/
20
+ parts/
21
+ sdist/
22
+ var/
23
+ wheels/
24
+ share/python-wheels/
25
+ *.egg-info/
26
+ .installed.cfg
27
+ *.egg
28
+ MANIFEST
29
+ *.zip
30
+
31
+ # Virtual environments
32
+ .env
33
+ .venv
34
+ env/
35
+ venv/
36
+ ENV/
37
+ env.bak/
38
+ venv.bak/
39
+
40
+ # Testing & Coverage
41
+ .tox/
42
+ .nox/
43
+ .coverage
44
+ .coverage.*
45
+ .cache
46
+ nosetests.xml
47
+ coverage.xml
48
+ *.cover
49
+ *.py,cover
50
+ .hypothesis/
51
+ .pytest_cache/
52
+ site/
53
+ cover/
54
+
55
+ # MyPy & Typing
56
+ .mypy_cache/
57
+ .dmypy.json
58
+ dmypy.json
59
+
60
+ # Ruff & Linters
61
+ .ruff_cache/
62
+
63
+ # IDEs
64
+ .idea/
65
+ .vscode/
66
+ *.swp
67
+ *.swo
68
+ *~
69
+ .DS_Store
70
+
71
+ # Logs
72
+ *.log
73
+ *.sqlite3
74
+ *.db
75
+
76
+ # FME specific outputs & temp files
77
+ *.fmw.recover
78
+ *.fme
79
+ *.ffs
80
+ *.fdr
81
+ fme_temp/
82
+
83
+
@@ -0,0 +1,10 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/mcp-server-config.json",
3
+ "name": "fme-mcp",
4
+ "version": "1.1.0",
5
+ "description": "Model Context Protocol server for Safe Software FME (2018.0 - 2026+)",
6
+ "transport": "stdio",
7
+ "command": "uvx",
8
+ "args": ["fme-mcp", "serve", "--transport", "stdio"]
9
+ }
10
+
@@ -0,0 +1,43 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ---
9
+
10
+ ## [1.1.0] - 2026-11-06
11
+
12
+ ### Added
13
+ - **Desktop Interactivity Suite**:
14
+ - `fme_diagnose`: System and environment diagnostic for FME installation, build, licensing, active processes, and bridge readiness.
15
+ - `fme_inspect_canvas`: Structured `.fmw` XML canvas topology extraction (transformers with coordinates, links, unconnected port warnings).
16
+ - `fme_open_in_workbench`: Non-blocking detached launcher for FME Workbench GUI.
17
+ - `fme_open_in_inspector`: Instant dataset opening in FME Data Inspector GUI.
18
+ - `fme_preview_dataset`: Direct in-chat preview of GeoPackage, SQLite, CSV, and Excel tables and schemas.
19
+ - `FMEBridgeServer` & `FMEBridgeClient`: Loopback TCP socket bridge on `127.0.0.1:9877`.
20
+
21
+ ### Changed
22
+ - **Zero-Configuration Generalisation**: Path resolution dynamically adapts to user home (`~`) and working directories without requiring explicit environment variables.
23
+ - **Repository Streamlining**: Removed redundant Kubernetes and Helm charts to keep the Python package lightweight and focused on MCP core functionality.
24
+ - Expanded automated test coverage to 32 tests spanning security, desktop tools, and MCP server calls.
25
+
26
+ ---
27
+
28
+ ## [1.0.0] - 2026-11-06
29
+
30
+ ### Added
31
+ - Initial public release of `fme-mcp`.
32
+ - Universal compatibility with Safe Software FME 2018.0 through 2026+ (FME Form and FME Flow).
33
+ - Universal MCP transports: Standard I/O (`stdio`) and Streamable HTTP (`sse`).
34
+ - Dynamic workspace-to-MCP engine automatically converting `.fmw` workspaces into validated MCP tools.
35
+ - Enterprise security engine including:
36
+ - `PathGuard` for directory sandboxing and path traversal prevention.
37
+ - `CommandGuard` for secure subprocess execution without shell expansion.
38
+ - `SSRF Guard` protecting internal networks and cloud metadata services.
39
+ - PII redaction and secret scrubbing in logs and data outputs.
40
+ - Comprehensive tool catalogue spanning spatial analysis, data engineering, quality verification, and metadata.
41
+ - Pre-configured client settings for Claude Desktop, Cursor, Antigravity, and VS Code.
42
+ - Automated CI/CD pipelines for linting, security scanning, container builds, and documentation.
43
+
@@ -0,0 +1,48 @@
1
+ # Contributor Covenant Code of Conduct
2
+
3
+ ## Our Pledge
4
+
5
+ We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, colour, religion, or sexual identity and orientation.
6
+
7
+ We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
8
+
9
+ ## Our Standards
10
+
11
+ Examples of behaviour that contributes to a positive environment for our community include:
12
+
13
+ * Demonstrating empathy and kindness toward other people
14
+ * Being respectful of differing opinions, viewpoints, and experiences
15
+ * Giving and gracefully accepting constructive feedback
16
+ * Accepting responsibility and apologising to those affected by our mistakes, and learning from the experience
17
+ * Focusing on what is best not just for us as individuals, but for the overall community
18
+
19
+ Examples of unacceptable behaviour include:
20
+
21
+ * The use of sexualised language or imagery, and sexual attention or advances of any kind
22
+ * Trolling, insulting or derogatory comments, and personal or political attacks
23
+ * Public or private harassment
24
+ * Publishing others' private information, such as a physical or email address, without their explicit permission
25
+ * Other conduct which could reasonably be considered inappropriate in a professional setting
26
+
27
+ ## Enforcement Responsibilities
28
+
29
+ Community leaders are responsible for clarifying and enforcing our standards of acceptable behaviour and will take appropriate and fair corrective action in response to any behaviour that they deem inappropriate, threatening, offensive, or harmful.
30
+
31
+ ## Enforcement Guidelines
32
+
33
+ Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
34
+
35
+ 1. **Correction**: A private, written warning providing clarity around the nature of the violation.
36
+ 2. **Warning**: A warning with consequences for continued behaviour.
37
+ 3. **Temporary Ban**: A temporary ban from any sort of interaction or public communication.
38
+ 4. **Permanent Ban**: A permanent ban from any sort of public interaction within the community.
39
+
40
+ ## Contact & Reporting
41
+
42
+ Instances of abusive, harassing, or otherwise unacceptable behaviour may be reported to the project maintainers at `mohamed.wael.jouini@gmail.com`. All complaints will be reviewed and investigated promptly and fairly.
43
+
44
+ ## Attribution
45
+
46
+ This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.
47
+
48
+