Merge pull request #5 from railsware/use-node

Migrate to NodeJS

Author: oshchyhol

.env.example

@@ -1,5 +1,3 @@
-# See https://github.com/oven-sh/bun/blob/500199fe8b61bde69a73a635e1546c2c099ca282/docs/runtime/env.md
-
 NODE_ENV=development
 COUPLER_API_HOST=http://lvh.me:3000/mcp
 COUPLER_ACCESS_TOKEN=<your_token>

.github/workflows/lint-and-test.yml

@@ -12,29 +12,34 @@ jobs:
     - name: Checkout code
       uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
 
-    - name: Set up Bun
-      uses: oven-sh/setup-bun@735343b667d3e6f658f44d0eca948eb6282f2b76 # v2.0.2
-      id: setup-bun
+    - name: Set up Node
+      uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+      id: setup-node
       with:
-        bun-version-file: .tool-versions
+        node-version-file: .tool-versions
 
-    - name: Save & restore bun install and node_modules cache
-      uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
-      id: bun-cache
+    - name: Get npm cache directory
+      id: npm-cache-dir
+      shell: bash
+      run: echo "dir=$(npm config get cache)" >> ${GITHUB_OUTPUT}
+
+    - name: Save & restore node cache
+      uses: actions/cache@v4
+      id: npm-cache # use this to check for `cache-hit` ==> if: steps.npm-cache.outputs.cache-hit != 'true'
       with:
-        path: |
-          ~/.bun/install/cache
-          node_modules
-        key: ${{ runner.os }}-${{ steps.setup-bun.outputs.bun-version }}-node_modules-${{ hashFiles('bun.lock') }}
+        path: ${{ steps.npm-cache-dir.outputs.dir }}
+        key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+        restore-keys: |
+          ${{ runner.os }}-node-
 
     - name: Install dependencies
       run: |
-        bun install --frozen-lockfile
+        npm ci
 
     - name: Lint code
       run: |
-        bun lint
+        npm run lint
 
     - name: Run tests
       run: |
-        bun test
+        npm run test

.gitignore

@@ -7,10 +7,6 @@ yarn-error.log*
 lerna-debug.log*
 .pnpm-debug.log*
 
-# Bun
-package-lock.json
-.bun
-
 # Misc
 .DS_Store
 

.npmrc

@@ -0,0 +1 @@
+loglevel=silent

.tool-versions

@@ -1,2 +1 @@
-nodejs 22.14.0
-bun 1.2.12
+nodejs 22.15.1

README.md

@@ -20,6 +20,7 @@ The Coupler.io MCP Server is a Model Context Protocol (MCP) server that provides
       "command": "docker",
       "args": [
         "run",
+        "--pull=always",
         "-e",
         "COUPLER_ACCESS_TOKEN",
         "--rm",
@@ -34,6 +35,9 @@ The Coupler.io MCP Server is a Model Context Protocol (MCP) server that provides
 }
 ```
 
+NOTE: `"--pull=always"` will ensure you always have the latest image by pulling it from the registry.
+Remove this line, if you're offline or if you specifically want to use the image you've already pulled previously.
+
 ## Tools
 ### Data flows
 - **get-data** - Gets the result of a data flow run as a SQLite file and executes a read-only query on it.
@@ -45,17 +49,15 @@ The Coupler.io MCP Server is a Model Context Protocol (MCP) server that provides
 
 ## Development
 
-Install Bun and NodeJS:
+Install NodeJS:
 ```shell
-# Add Bun plugin
-asdf plugin add bun
 asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git
 asdf install
 ```
 
 Install dependencies:
 ```shell
-bun install
+npm install
 ```
 
 Install Git hooks:
@@ -71,20 +73,20 @@ cp .env.example .env.local
 ### Work with a raw server
 Run the MCP server:
 ```shell
-bun start
+npm run dev
 ```
 
 #### Run [MCP server inspector](https://github.com/modelcontextprotocol/inspector) for debugging
 Caveat: make sure to keep only a single inspector tab open at all times, until [this inspector bug](https://github.com/modelcontextprotocol/inspector/issues/302) is fixed.
 ```shell
 # Run this and follow the instructions to view the inspector
-bun inspect:bun
+npm run inspect:node
 ```
 
 #### Tail logs
 Our local MCP server uses STDIO transport, therefore logs must go to a file. This may come in handy when debugging.
 ```shell
-tail -f log/development.log | bun pino-pretty
+tail -f log/development.log | npx pino-pretty
 ```
 You can also optionally capture STDIO messages in the log file by setting `LOG_STDIO=1` when running the server.
 If you're debugging a containerized server, you'd likely want to mount a dir at `/app/log` to be able to access the logs it generates.
@@ -97,7 +99,7 @@ bin/build_image
 
 You can now run the container with the MCP inspector for debugging:
 ```shell
-bun inspect:docker
+npm run inspect:docker
 ```
 
 Or run the container within Claude Desktop, configured with your `.env.local` file in the project.

bun.lock

@@ -15,9 +15,10 @@
         "coupler-io-mcp-server-development"
       ]
     },
-    "coupler_bun": {
-      "command": "bun",
+    "coupler_node": {
+      "command": "npm",
       "args": [
+        "run",
         "dev"
       ]
     }

bunfig.toml

@@ -1,4 +1,4 @@
-FROM oven/bun:1.2.12-slim AS base
+FROM node:22.15.1-slim AS base
 
 ENV NODE_ENV=production
 ENV COUPLER_API_HOST=https://app.coupler.io/mcp
@@ -8,15 +8,15 @@ WORKDIR /app
 
 FROM base AS install
 WORKDIR /temp/install
-COPY package.json bun.lock ./
-RUN bun install --frozen-lockfile --production
+COPY package.json package-lock.json ./
+RUN npm ci
 
 FROM base AS final
 COPY --from=install /temp/install/node_modules node_modules
 COPY . .
 # We may write logs to this dir
-RUN chown -R bun:bun /app/log
+RUN chown -R node:node /app/log
 
-USER bun
+USER node
 
-CMD ["bun", "start"]
+CMD ["npm", "run", "--silent", "start"]