spec improvements on how they run in github action to improve flakiness

try port rotation to get more consitancy on server builds

check if envs are set

add ports to the test running command

remove the listene command

more spec changes to support changing ports dynamically

add dependency install

bundle install from bun install

change order of dep install

fixed action syntax

rename

Author: patvice

.github/workflows/cicd.yml

@@ -0,0 +1,58 @@
+name: Ruby
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    name: Ruby ${{ matrix.ruby }}
+    strategy:
+      matrix:
+        ruby: ['3.1.3', '3.2', '3.3', '3.4']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.2.16
+
+      - name: Install dependencies for typescript-mcp && pagination-server
+        run: |
+          cd spec/fixtures/typescript-mcp
+          bun install
+          cd ../pagination-server
+          bun install
+          cd ../../..
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - name: Install dependencies for gem and fast-mcp
+        run: |
+          bundle install
+          cd spec/fixtures/fast-mcp-ruby
+          bundle install
+          cd ../../..
+
+
+      - name: Generate random ports
+        id: portgen
+        run: |
+          echo "PORT1=$(( (RANDOM % 1000) + 3000 ))" >> $GITHUB_ENV
+          echo "PORT2=$(( (RANDOM % 1000) + 4000 ))" >> $GITHUB_ENV
+          echo "PORT3=$(( (RANDOM % 1000) + 5000 ))" >> $GITHUB_ENV
+
+      - name: Run the test suite
+        run: PORT1=$PORT1 PORT2=$PORT2 PORT3=$PORT3 bundle exec rake
+        env:
+          PORT1: ${{ env.PORT1 }}
+          PORT2: ${{ env.PORT2 }}
+          PORT3: ${{ env.PORT3 }}

.github/workflows/main.yml

@@ -16,7 +16,7 @@
   name: "streamable_mcp",
   transport_type: :streamable,
   config: {
-    url: "http://localhost:3005/mcp"
+    url: "http://localhost:#{ENV.fetch('PORT1', 3005)}/mcp"
   }
 )
 

examples/tools/streamable_mcp.rb

@@ -9,6 +9,7 @@
 require "rack/handler/puma"
 
 is_silent = ARGV.include?("--silent")
+port = ENV.fetch("PORT2", 3006)
 
 class NullWriter
   def write(*args)
@@ -107,10 +108,10 @@ def content
 
 unless is_silent
   # Run the Rack application with Puma
-  puts "Starting Rack application with MCP middleware on http://localhost:3006"
+  puts "Starting Rack application with MCP middleware on http://localhost:#{port}"
   puts "MCP endpoints:"
-  puts "  - http://localhost:3006/mcp/sse (SSE endpoint)"
-  puts "  - http://localhost:3006/mcp/messages (JSON-RPC endpoint)"
+  puts "  - http://localhost:#{port}/mcp/sse (SSE endpoint)"
+  puts "  - http://localhost:#{port}/mcp/messages (JSON-RPC endpoint)"
   puts "Press Ctrl+C to stop"
 end
 
@@ -124,7 +125,7 @@ def content
 log_writer = is_silent ? Puma::LogWriter.new(NullWriter.new, NullWriter.new) : Puma::LogWriter.stdio
 
 config = Puma::Configuration.new(log_writer: log_writer) do |user_config|
-  user_config.bind "tcp://localhost:3006"
+  user_config.bind "tcp://127.0.0.1:#{port}"
   user_config.app app
 end
 

spec/fixtures/fast-mcp-ruby/lib/app.rb

@@ -295,7 +295,7 @@ if (process.argv.includes("--stdio")) {
     process.exit(1);
   });
 } else {
-  const PORT = process.env.PORT || 3007;
+  const PORT = process.env.PORT3 || 3007;
   app.listen(PORT, () => {
     log(`🚀 MCP Streamable server running on port ${PORT}`);
     log(`📡 Endpoint: http://localhost:${PORT}/mcp`);

spec/fixtures/pagination-server/src/index.ts

@@ -297,7 +297,7 @@ if (process.argv.includes("--stdio")) {
     process.exit(1);
   });
 } else {
-  const PORT = process.env.PORT || 3005;
+  const PORT = process.env.PORT1 || 3005;
   app.listen(PORT, () => {
     log(`🚀 MCP Streamable server running on port ${PORT}`);
     log(`📡 Endpoint: http://localhost:${PORT}/mcp`);

spec/fixtures/typescript-mcp/src/index.ts

@@ -20,7 +20,7 @@ def client
       name: "fast-mcp-ruby",
       transport_type: :sse,
       config: {
-        url: "http://127.0.0.1:3006/mcp/sse",
+        url: "http://127.0.0.1:#{TestServerManager::PORTS[:sse]}/mcp/sse",
         request_timeout: 100
       }
     )