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.
- fme_mcp-1.1.0/.env.example +43 -0
- fme_mcp-1.1.0/.github/CODEOWNERS +3 -0
- fme_mcp-1.1.0/.github/FUNDING.yml +2 -0
- fme_mcp-1.1.0/.github/ISSUE_TEMPLATE/bug_report.yml +36 -0
- fme_mcp-1.1.0/.github/ISSUE_TEMPLATE/feature_request.yml +25 -0
- fme_mcp-1.1.0/.github/ISSUE_TEMPLATE/security_report.yml +15 -0
- fme_mcp-1.1.0/.github/PULL_REQUEST_TEMPLATE.md +23 -0
- fme_mcp-1.1.0/.github/workflows/ci.yml +71 -0
- fme_mcp-1.1.0/.github/workflows/docs.yml +33 -0
- fme_mcp-1.1.0/.github/workflows/publish.yml +36 -0
- fme_mcp-1.1.0/.github/workflows/release-binaries.yml +80 -0
- fme_mcp-1.1.0/.github/workflows/release.yml +77 -0
- fme_mcp-1.1.0/.github/workflows/security.yml +45 -0
- fme_mcp-1.1.0/.gitignore +83 -0
- fme_mcp-1.1.0/.mcp.json +10 -0
- fme_mcp-1.1.0/CHANGELOG.md +43 -0
- fme_mcp-1.1.0/CODE_OF_CONDUCT.md +48 -0
- fme_mcp-1.1.0/CONTRIBUTING.md +75 -0
- fme_mcp-1.1.0/Dockerfile +61 -0
- fme_mcp-1.1.0/GOVERNANCE.md +18 -0
- fme_mcp-1.1.0/LICENSE +191 -0
- fme_mcp-1.1.0/PKG-INFO +337 -0
- fme_mcp-1.1.0/README.md +285 -0
- fme_mcp-1.1.0/ROADMAP.md +29 -0
- fme_mcp-1.1.0/SECURITY.md +44 -0
- fme_mcp-1.1.0/SUPPORT.md +15 -0
- fme_mcp-1.1.0/docker-compose.yml +27 -0
- fme_mcp-1.1.0/docs/assets/fme_hub_logo_200x200.png +0 -0
- fme_mcp-1.1.0/docs/assets/logo.jpg +0 -0
- fme_mcp-1.1.0/docs/assets/logo.png +0 -0
- fme_mcp-1.1.0/docs/authentication.md +47 -0
- fme_mcp-1.1.0/docs/code-of-conduct.md +29 -0
- fme_mcp-1.1.0/docs/configuration.md +17 -0
- fme_mcp-1.1.0/docs/contributing.md +37 -0
- fme_mcp-1.1.0/docs/deployment.md +26 -0
- fme_mcp-1.1.0/docs/desktop-integration.md +43 -0
- fme_mcp-1.1.0/docs/docker.md +78 -0
- fme_mcp-1.1.0/docs/fme-2026-parity.md +25 -0
- fme_mcp-1.1.0/docs/fme-compatibility.md +33 -0
- fme_mcp-1.1.0/docs/index.md +30 -0
- fme_mcp-1.1.0/docs/installation.md +223 -0
- fme_mcp-1.1.0/docs/mcp-clients.md +99 -0
- fme_mcp-1.1.0/docs/observability.md +50 -0
- fme_mcp-1.1.0/docs/roadmap.md +39 -0
- fme_mcp-1.1.0/docs/security.md +33 -0
- fme_mcp-1.1.0/docs/tools.md +149 -0
- fme_mcp-1.1.0/examples/antigravity/antigravity_config.json +18 -0
- fme_mcp-1.1.0/examples/claude-desktop/claude_desktop_config.json +17 -0
- fme_mcp-1.1.0/examples/curl/call_tool.sh +15 -0
- fme_mcp-1.1.0/examples/cursor/mcp.json +13 -0
- fme_mcp-1.1.0/examples/fme-workbench/fme_startup_hook.py +72 -0
- fme_mcp-1.1.0/examples/fme-workbench/shutdown_script.py +46 -0
- fme_mcp-1.1.0/examples/fme-workbench/startup_script.py +34 -0
- fme_mcp-1.1.0/examples/python-client/client_example.py +26 -0
- fme_mcp-1.1.0/examples/workbench/MCPAgentBridge_Demo.fmw +141 -0
- fme_mcp-1.1.0/glama.json +7 -0
- fme_mcp-1.1.0/mkdocs.yml +67 -0
- fme_mcp-1.1.0/pyproject.toml +105 -0
- fme_mcp-1.1.0/scripts/build_demo_workspace.py +171 -0
- fme_mcp-1.1.0/scripts/build_fme_transformer.py +242 -0
- fme_mcp-1.1.0/scripts/build_standalone.py +339 -0
- fme_mcp-1.1.0/scripts/install.ps1 +683 -0
- fme_mcp-1.1.0/scripts/install.sh +445 -0
- fme_mcp-1.1.0/skill/README.md +30 -0
- fme_mcp-1.1.0/skill/fme-spatial-engineer/SKILL.md +117 -0
- fme_mcp-1.1.0/skill/logo.png +0 -0
- fme_mcp-1.1.0/skill/logo_3d.jpg +0 -0
- fme_mcp-1.1.0/smithery.yaml +32 -0
- fme_mcp-1.1.0/src/fme_mcp/__init__.py +12 -0
- fme_mcp-1.1.0/src/fme_mcp/__main__.py +8 -0
- fme_mcp-1.1.0/src/fme_mcp/cli/main.py +156 -0
- fme_mcp-1.1.0/src/fme_mcp/core/config.py +84 -0
- fme_mcp-1.1.0/src/fme_mcp/core/errors.py +80 -0
- fme_mcp-1.1.0/src/fme_mcp/core/logging.py +35 -0
- fme_mcp-1.1.0/src/fme_mcp/core/schema.py +35 -0
- fme_mcp-1.1.0/src/fme_mcp/fme/compatibility_layer.py +55 -0
- fme_mcp-1.1.0/src/fme_mcp/fme/fme_bridge.py +165 -0
- fme_mcp-1.1.0/src/fme_mcp/fme/fme_flow_client.py +133 -0
- fme_mcp-1.1.0/src/fme_mcp/fme/fme_form_client.py +665 -0
- fme_mcp-1.1.0/src/fme_mcp/fme/parameter_mapper.py +40 -0
- fme_mcp-1.1.0/src/fme_mcp/fme/transformer_bridge.py +143 -0
- fme_mcp-1.1.0/src/fme_mcp/security/audit_log.py +44 -0
- fme_mcp-1.1.0/src/fme_mcp/security/command_guard.py +57 -0
- fme_mcp-1.1.0/src/fme_mcp/security/path_guard.py +64 -0
- fme_mcp-1.1.0/src/fme_mcp/security/rbac.py +98 -0
- fme_mcp-1.1.0/src/fme_mcp/security/redaction.py +50 -0
- fme_mcp-1.1.0/src/fme_mcp/security/ssrf_guard.py +67 -0
- fme_mcp-1.1.0/src/fme_mcp/server/mcp_server.py +408 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/ai/ai_tools.py +104 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/catalog/catalog_tools.py +69 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/datasets/dataset_tools.py +105 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/governance/governance_tools.py +68 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/mcp_federation/federation_tools.py +47 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/orchestration/workflow_tools.py +74 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/quality/quality_tools.py +78 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/spatial/spatial_tools.py +912 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/utilities/util_tools.py +86 -0
- fme_mcp-1.1.0/src/fme_mcp/tools/workspaces/workspace_tools.py +1186 -0
- fme_mcp-1.1.0/tests/integration/test_server_mcp.py +57 -0
- fme_mcp-1.1.0/tests/unit/test_enhanced_features.py +546 -0
- fme_mcp-1.1.0/tests/unit/test_fme_desktop.py +169 -0
- fme_mcp-1.1.0/tests/unit/test_security.py +99 -0
- fme_mcp-1.1.0/tests/unit/test_tools.py +99 -0
- fme_mcp-1.1.0/tests/unit/test_transformer_bridge.py +66 -0
- fme_mcp-1.1.0/transformers/MCPAgentBridge.fmx +104 -0
- 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,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
|
+
|
fme_mcp-1.1.0/.gitignore
ADDED
|
@@ -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
|
+
|
fme_mcp-1.1.0/.mcp.json
ADDED
|
@@ -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
|
+
|