Merge pull request #6 from railsware/CPL-19830/list-dataflows

[CPL-19830] list dataflows

Author: oshchyhol

.env.example

@@ -10,3 +10,6 @@ LOG_STDIO=1
 # Set the log level: trace, debug, info, warn, error, fatal, silent.
 # Defaults to `info`, if not set.
 LOG_LEVEL=debug
+
+# App version, this gets added to the User-Agent header when calling Coupler.io API.
+APP_VERSION=development

.env.test

@@ -3,3 +3,4 @@ COUPLER_API_HOST=http://lvh.me:3000/mcp
 COUPLER_ACCESS_TOKEN=test_token
 LOG_LEVEL=debug
 LOG_STDIO=1
+APP_VERSION=test

.github/workflows/publish-docker-image.yml

@@ -65,6 +65,8 @@ jobs:
         with:
           context: .
           file: docker/Dockerfile
+          build-args: |
+            APP_VERSION=${{ github.sha }}
           push: true
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}

README.md

@@ -97,7 +97,7 @@ Build Docker image for development:
 bin/build_image
 ```
 
-You can now run the container with the MCP inspector for debugging:
+You can now run the container with the MCP inspector for debugging in UI mode:
 ```shell
 npm run inspect:docker
 ```
@@ -128,6 +128,20 @@ Edit your `claude_desktop_config.json`, add an entry for our server:
 }
 ```
 
+### Using MCP inspector
+[Use MCP inspector in CLI mode](https://github.com/modelcontextprotocol/inspector/blob/24e8861a88f843d57cdb637a5ae3afd0e528c5f3/README.md#cli-mode) for smoke testing the server with a short feedback loop:
+
+```shell
+# List tools
+npx @modelcontextprotocol/inspector --cli npm run dev --method tools/list
+
+# Call list-dataflows tool
+npx @modelcontextprotocol/inspector --cli npm run dev --method tools/call --tool-name list-dataflows
+
+# Call get-schema tool
+npx @modelcontextprotocol/inspector --cli npm run dev --method tools/call --tool-name get-schema --tool-arg dataflowId=<your data flow ID>
+```
+
 ### Testing the Docker image against Coupler.io staging
 We build and publish a Docker image with of our MCP server, tagged `edge`, on every push to the `main` branch.
 

docker/Dockerfile

@@ -1,8 +1,11 @@
 FROM node:22.15.1-slim AS base
 
+ARG APP_VERSION=development
+
 ENV NODE_ENV=production
 ENV COUPLER_API_HOST=https://app.coupler.io/mcp
 ENV LOG_LEVEL=silent
+ENV APP_VERSION=$APP_VERSION
 
 WORKDIR /app