# Add to your Claude Code skills
git clone https://github.com/guillaumegay13/fieldflowFieldFlow turns OpenAPI-described REST endpoints into selectively filtered tools. It generates Pydantic models and FastAPI routes that forward requests to the upstream API and return only the fields the caller asks for. An optional MCP layer exposes the same functionality to Model Context Protocol clients such as Claude Desktop.
fields
list to slice responses.httpx, automatically formatting URL paths and query
parameters.fieldflow/
config.py # Environment-based settings
http_app.py # FastAPI app factory
openapi_loader.py # JSON/YAML loader with PyYAML fallback
proxy.py # Async HTTP proxy that filters responses to requested fields
spec_parser.py # Schema parser and dynamic Pydantic model generator
tooling.py # FastAPI router builder for tool endpoints
fieldflow_mcp/
server.py # MCP server wrapper built on FastMCP
cli.py # CLI entry point for the MCP server
examples/
jsonplaceholder_openapi.yaml # Minimal sample spec
pokeapi_openapi.yaml # Larger spec for stress-testing
python -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -e '.[mcp]' # zsh users: quote to avoid globbing
# Alternatively: pip install -r requirements.txt
fieldflow serve-http --reload
No comments yet. Be the first to share your thoughts!
OpenAPI specs are resolved from FIELD_FLOW_OPENAPI_SPEC_PATH. If the spec
includes a servers entry the first URL is used; otherwise set
FIELD_FLOW_TARGET_API_BASE_URL.
| Variable | Description | Default |
| --- | --- | --- |
| FIELD_FLOW_OPENAPI_SPEC_PATH | Path to the OpenAPI JSON/YAML file | examples/jsonplaceholder_openapi.yaml |
| FIELD_FLOW_TARGET_API_BASE_URL | Upstream REST API base URL (overrides spec servers) | derived from spec |
FieldFlow supports secure API authentication through environment variables. All credentials are handled securely with automatic sanitization in logs and error messages.
# Bearer token (OAuth 2.0, JWT)
export FIELDFLOW_AUTH_TYPE=bearer
export FIELDFLOW_AUTH_VALUE=your-token-here
# API Key
export FIELDFLOW_AUTH_TYPE=apikey
export FIELDFLOW_AUTH_HEADER=X-API-Key # Optional, defaults to X-API-Key
export FIELDFLOW_AUTH_VALUE=your-api-key-here
# Basic authentication
export FIELDFLOW_AUTH_TYPE=basic
export FIELDFLOW_AUTH_VALUE=base64-encoded-credentials
When your OpenAPI spe...