Skip to main content

MCP server for Metaflow -- expose flow runs, logs, and artifacts as tools for AI coding agents

Project description

Metaflow MCP Server

CI PyPI Python License MCP

Give your coding agent superpowers over your Metaflow workflows. Instead of writing throwaway scripts to check run status or dig through logs, just ask -- your agent will figure out the rest.

Works with any Metaflow backend: local, S3, Azure, GCS, or Netflix internal.

demo

Tools

Tool Description
get_config What backend am I connected to?
search_runs Find recent runs of any flow
get_run Step-by-step breakdown of a run
get_task_logs Pull stdout/stderr from a task
list_artifacts What did this step produce?
get_artifact Grab an artifact's value
get_latest_failure What broke and why?

Quickstart

pip install metaflow-mcp-server
claude mcp add --scope user metaflow -- metaflow-mcp-server

That's it. Restart Claude Code and start asking questions about your flows.

If Metaflow lives in a specific venv, point to it:

claude mcp add --scope user metaflow -- /path/to/venv/bin/metaflow-mcp-server

For other MCP clients, the server speaks stdio: metaflow-mcp-server

How it works

Wraps the Metaflow client API. Whatever backend your Metaflow is pointed at, the server uses too -- no separate config needed. Sets namespace(None) at startup so production runs (Argo, Step Functions, Maestro) are visible alongside your dev runs.

Starts once per session, communicates over stdin/stdout. No daemon, no port.

License

Apache-2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

metaflow_mcp_server-0.1.3.tar.gz (14.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

metaflow_mcp_server-0.1.3-py3-none-any.whl (11.5 kB view details)

Uploaded Python 3

File details

Details for the file metaflow_mcp_server-0.1.3.tar.gz.

File metadata

  • Download URL: metaflow_mcp_server-0.1.3.tar.gz
  • Upload date:
  • Size: 14.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for metaflow_mcp_server-0.1.3.tar.gz
Algorithm Hash digest
SHA256 a85563841ce13713de0aec9ac75e0e75dc387285ec5062d0e6149416b3f78204
MD5 1653764a59422e32446818298beade80
BLAKE2b-256 d23b002f986fabfaa51664e2d01aef7d30340bf701f405448b7a27c97ff9403f

See more details on using hashes here.

Provenance

The following attestation bundles were made for metaflow_mcp_server-0.1.3.tar.gz:

Publisher: publish.yml on npow/metaflow-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file metaflow_mcp_server-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for metaflow_mcp_server-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 be6404dfc7890361580a0c91ca36dc1f85e8f96f6432f2d5cd8a6a3796c35501
MD5 199d629c51fc2a3766984bea91aa9854
BLAKE2b-256 b37f95f1f3c4d9cb8f24ade9199d9502c1eb80963c88bc544ff94ecce5395cc6

See more details on using hashes here.

Provenance

The following attestation bundles were made for metaflow_mcp_server-0.1.3-py3-none-any.whl:

Publisher: publish.yml on npow/metaflow-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page