add github actions, fix go shadowing issues

    - add shellcheck github action
    - add go test github action
    - add golangci linte github action
    - fix bash script shebang and file extension

Author: vigo

Diff for: .github/workflows/go-lint.yml

@@ -0,0 +1,32 @@
+name: Run golangci-lint
+
+on:
+  pull_request:
+    paths:
+      - '**.go'
+  push:
+    branches:
+      - main
+    paths:
+      - '**.go'
+
+concurrency:
+  group: golangci-lint-mcp
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Run golangci-lint
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: "go.mod"
+
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v7
+        with:
+          version: v2.0
+          args: --timeout=5m

Diff for: .github/workflows/go-test.yml

@@ -0,0 +1,31 @@
+name: Run go tests
+
+on:
+  pull_request:
+    paths:
+      - '**.go'
+  push:
+    branches:
+      - main
+    tags-ignore:
+      - '**'
+    paths:
+      - '**.go'
+
+concurrency:
+  group: mcp-go-test
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Run tests
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: "go.mod"
+        id: go
+
+      - name: Run tests
+        run: go test -race -v ./...

Diff for: .github/workflows/shellcheck.yml

@@ -0,0 +1,24 @@
+name: Shellcheck
+
+on:
+  pull_request:
+    paths:
+      - '**.bash'
+  push:
+    branches:
+      - main
+    tags-ignore:
+      - '**'
+    paths:
+      - '**.bash'
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Run shellchecker
+        run: |
+          shellcheck --shell=bash scripts/*.bash

Diff for: .golangci.yml

@@ -1,90 +1,50 @@
+version: "2"
 run:
-  timeout: 5m
+  concurrency: 4
   modules-download-mode: readonly
-  allow-parallel-runners: true
-  go: '1.24'
-
-output:
-  format: colored-line-number
-  sort-results: true
-
-linters-settings:
-  revive:
-    rules:
-      - name: exported
-        severity: warning
-        disabled: false
-        arguments:
-          - checkPrivateReceivers
-          - sayRepetitiveInsteadOfStutters
-      - name: unexported-return
-        severity: warning
-        disabled: false
-      - name: unused-parameter
-        severity: warning
-        disabled: false
-  govet:
-    check-shadowing: true
-  gocyclo:
-    min-complexity: 15
-  dupl:
-    threshold: 100
-  goconst:
-    min-len: 2
-    min-occurrences: 3
-  misspell:
-    locale: US
-  goimports:
-    local-prefixes: github.com/f/mcptools
-  gofumpt:
-    extra-rules: true
-  nolintlint:
-    allow-unused: false
-    require-explanation: true
-    require-specific: true
 
 linters:
-  disable-all: true
   enable:
-    - bodyclose
-    - dogsled
-    - dupl
-    - errcheck
-    - exportloopref
+    - errorlint
     - goconst
     - gocritic
     - gocyclo
-    - gofmt
-    - gofumpt
-    - goimports
+    - godot
+    - godox
+    - gomoddirectives
     - gosec
-    - gosimple
-    - govet
-    - ineffassign
-    - misspell
-    - nakedret
-    - noctx
-    - nolintlint
+    - makezero
+    - nilerr
     - revive
-    - staticcheck
-    - stylecheck
-    - typecheck
-    - unconvert
-    - unused
+    - unparam
+  settings:
+    errcheck:
+      exclude-functions:
+        - fmt.Fprintln
+        - fmt.Fprintf
+    govet:
+      enable-all: true
+      settings:
+        shadow:
+          strict: true
+  exclusions:
+    generated: lax
+    paths:
+      - third_party$
+      - builtin$
+      - examples$
 
 issues:
-  exclude-rules:
-    - path: _test\.go
-      linters:
-        - dupl
-        - gosec
-        - gomnd
-    - path: pkg/jsonutils
-      linters:
-        - dupl
-    - path: cmd/mcptools/main.go
-      linters:
-        - gocyclo
   max-issues-per-linter: 0
   max-same-issues: 0
-  fix: false 
+formatters:
+  enable:
+    - gofmt
+    - gofumpt
+    - goimports
+  exclusions:
+    generated: lax
+    paths:
+      - third_party$
+      - builtin$
+      - examples$

Diff for: Makefile

@@ -25,8 +25,8 @@ setup: \
 
 check-go:
 	@echo "$(BLUE)Checking Go installation and version...$(NC)"
-	chmod +x ./scripts/check_go.sh
-	./scripts/check_go.sh
+	chmod +x ./scripts/check_go.bash
+	./scripts/check_go.bash
 
 build:
 	@echo "$(YELLOW)Building $(BINARY_NAME)...$(NC)"

Diff for: README.md

@@ -2,7 +2,8 @@
 
 [Read my Blog Post about MCP Tools](https://blog.fka.dev/blog/2025-03-26-introducing-mcp-tools-cli/)
 
-A command-line interface for interacting with MCP (Model Context Protocol) servers using both stdio and HTTP transport.
+A command-line interface for interacting with MCP (Model Context Protocol)
+servers using both stdio and HTTP transport.
 
 ## Overview
 
@@ -16,7 +17,9 @@ This will open a shell as following:
 
 ## Contributing
 
-We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and contribute to the project.
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) 
+for details on how to submit pull requests, report issues, and contribute to the 
+project.
 
 ## Installation
 
@@ -35,45 +38,46 @@ go install github.com/f/mcptools/cmd/mcptools@latest
 
 ## Usage
 
-```
-MCP is a command line interface for interacting with MCP servers.
-It allows you to discover and call tools, list resources, and interact with MCP-compatible services.
-
-Usage:
-  mcp [command]
+    MCP is a command line interface for interacting with MCP servers.
+    It allows you to discover and call tools, list resources, and interact with MCP-compatible services.
+    
+    Usage:
+      mcp [command]
+      
+    Available Commands:
+      call           Call a tool, resource, or prompt on the MCP server
+      help           Help about any command
+      prompts        List available prompts on the MCP server
+      resources      List available resources on the MCP server
+      shell          Start an interactive shell for MCP commands
+      tools          List available tools on the MCP server
+      version        Print the version information
+      
+    Flags:
+      -f, --format string   Output format (table, json, pretty) (default "table")
+      -h, --help            Help for mcp
+      -H, --http            Use HTTP transport instead of stdio
+      -p, --params string   JSON string of parameters to pass to the tool (default "{}")
+      -s, --server string   MCP server URL (when using HTTP transport) (default "http://localhost:8080")
 
-Available Commands:
-  call           Call a tool, resource, or prompt on the MCP server
-  help           Help about any command
-  prompts        List available prompts on the MCP server
-  resources      List available resources on the MCP server
-  shell          Start an interactive shell for MCP commands
-  tools          List available tools on the MCP server
-  version        Print the version information
-
-Flags:
-  -f, --format string   Output format (table, json, pretty) (default "table")
-  -h, --help            Help for mcp
-  -H, --http            Use HTTP transport instead of stdio
-  -p, --params string   JSON string of parameters to pass to the tool (default "{}")
-  -s, --server string   MCP server URL (when using HTTP transport) (default "http://localhost:8080")
-```
 
 ## Transport Options
 
 MCP supports two transport methods for communicating with MCP servers:
 
 ### Stdio Transport (Default)
 
-Uses stdin/stdout to communicate with an MCP server via JSON-RPC 2.0. This is useful for command-line tools that implement the MCP protocol.
+Uses stdin/stdout to communicate with an MCP server via JSON-RPC 2.0. This is
+useful for command-line tools that implement the MCP protocol.
 
 ```bash
 mcp tools npx -y @modelcontextprotocol/server-filesystem ~/Code
 ```
 
 ### HTTP Transport
 
-Uses HTTP protocol to communicate with an MCP server. Use the `--http` flag for HTTP transport.
+Uses HTTP protocol to communicate with an MCP server. Use the `--http` flag
+for HTTP transport.
 
 ```bash
 mcp --http tools --server "http://mcp.example.com:8080"
@@ -179,36 +183,35 @@ mcp shell npx -y @modelcontextprotocol/server-filesystem ~/Code
 
 This opens an interactive shell where you can run MCP commands:
 
-```
-mcp > connected to MCP server over stdio
-mcp > Type '/h' for help or '/q' to quit
-mcp > tools
-NAME        DESCRIPTION
-----        -----------
-read_file   Reads a file from the filesystem
-...
+    mcp > connected to MCP server over stdio
+    mcp > Type '/h' for help or '/q' to quit
+    mcp > tools
+    NAME        DESCRIPTION
+    ----        -----------
+    read_file   Reads a file from the filesystem
+    ...
+    
+    mcp > call read_file --params '{"path": "README.md"}'
+    ...content of README.md...
+    
+    # Direct tool calling is supported
+    mcp > read_file {"path": "README.md"}
+    ...content of README.md...
+    
+    mcp > /h
+    MCP Shell Commands:
+      tools                      List available tools
+      resources                  List available resources
+      prompts                    List available prompts
+      call <entity> [--params '{...}']  Call a tool, resource, or prompt
+      format [json|pretty|table] Get or set output format
+    Special Commands:
+      /h, /help                  Show this help
+      /q, /quit, exit            Exit the shell
+      
+    mcp > /q
+    Exiting MCP shell
 
-mcp > call read_file --params '{"path": "README.md"}'
-...content of README.md...
-
-# Direct tool calling is supported
-mcp > read_file {"path": "README.md"}
-...content of README.md...
-
-mcp > /h
-MCP Shell Commands:
-  tools                      List available tools
-  resources                  List available resources
-  prompts                    List available prompts
-  call <entity> [--params '{...}']  Call a tool, resource, or prompt
-  format [json|pretty|table] Get or set output format
-Special Commands:
-  /h, /help                  Show this help
-  /q, /quit, exit            Exit the shell
-
-mcp > /q
-Exiting MCP shell
-```
 
 ## Examples
 
@@ -238,4 +241,4 @@ mcp shell npx -y @modelcontextprotocol/server-filesystem ~/Code
 
 ## License
 
-MIT 
+This project is licensed under MIT