Implement basic MCP server

Author: ezynda3

.github/dependabot.yml

@@ -0,0 +1,15 @@
+version: 2
+updates:
+  - package-ecosystem: "gomod"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    groups:
+      minor-dependencies:
+        update-types:
+          - "minor"
+          - "patch"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

.github/workflows/release.yml

@@ -0,0 +1,58 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  goreleaser:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '>=1.21.0'
+          check-latest: true
+      
+      - name: Run GoReleaser
+        uses: goreleaser/goreleaser-action@v6
+        with:
+          distribution: goreleaser
+          version: '~> v2'
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Extract version
+        id: get-version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+      
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          platforms: linux/amd64,linux/arm64
+          tags: |
+            ghcr.io/${{ github.repository }}:latest
+            ghcr.io/${{ github.repository }}:${{ steps.get-version.outputs.VERSION }}

.github/workflows/test.yml

@@ -0,0 +1,21 @@
+name: Test 
+
+on: [push]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '>=1.21.0'
+          check-latest: true
+
+      - name: Run tests
+        run: go test ./...

.goreleaser.yml

@@ -0,0 +1,61 @@
+version: 2
+
+before:
+  hooks:
+    - go mod tidy
+
+builds:
+  - id: codebench-mcp
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
+    goarch:
+      - amd64
+      - arm64
+    ldflags:
+      - -s -w -X github.com/mark3labs/codebench-mcp/jsserver.Version={{.Version}}
+    binary: codebench-mcp
+    main: .
+
+archives:
+  - id: default
+    format_overrides:
+      - goos: windows
+        formats:
+          - zip
+    name_template: >-
+      {{ .ProjectName }}_
+      {{- .Os }}_
+      {{- .Arch }}
+    files:
+      - README.md
+      - LICENSE*
+
+checksum:
+  name_template: 'checksums.txt'
+  algorithm: sha256
+
+# Using new snapshot configuration
+snapshot:
+  version_template: "{{ .Version }}-SNAPSHOT-{{ .ShortCommit }}"
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - '^docs:'
+      - '^test:'
+      - Merge pull request
+      - Merge branch
+
+release:
+  github:
+    owner: mark3labs
+    name: codebench-mcp
+  draft: false
+  prerelease: auto
+  name_template: "{{ .Tag }}"
+  mode: replace

CONTEXT.md

@@ -0,0 +1,35 @@
+# CodeBench MCP - JavaScript Executor
+
+An MCP server that provides JavaScript execution capabilities with Node.js-like APIs.
+
+## Tool
+
+### executeJS
+- Execute JavaScript code with full Node.js-like environment
+- Includes: console, fs, http, timers (setTimeout/setInterval), process, and require
+- Parameters: `code` (required): JavaScript code to execute
+
+## Build/Test Commands
+- `go build ./...` - Build all packages
+- `go test ./...` - Run all tests
+- `go test -v ./...` - Run tests with verbose output
+- `go test -run TestName` - Run specific test
+- `go mod tidy` - Clean up dependencies
+- `go fmt ./...` - Format code
+- `go vet ./...` - Static analysis
+- `golangci-lint run` - Comprehensive linting (if configured)
+
+## Code Style Guidelines
+- Use `gofmt` for consistent formatting
+- Follow standard Go naming conventions: PascalCase for exported, camelCase for unexported
+- Package names should be lowercase, single words when possible
+- Use meaningful variable names, avoid abbreviations
+- Error handling: always check errors, wrap with context using `fmt.Errorf("context: %w", err)`
+- Imports: group standard library, third-party, then local packages with blank lines
+- Use interfaces for testability and loose coupling
+- Prefer composition over inheritance
+- Keep functions small and focused on single responsibility
+
+## Project Info
+- Go version: 1.23.10
+- Module: github.com/mark3labs/codebench-mcp

Dockerfile

@@ -0,0 +1,26 @@
+# Generated by https://smithery.ai. See: https://smithery.ai/docs/config#dockerfile
+FROM golang:1.23-alpine AS builder
+
+WORKDIR /app
+
+# Copy go.mod and go.sum first for caching dependencies
+COPY go.mod go.sum ./
+
+# Download dependencies
+RUN go mod download
+
+# Copy the source code
+COPY . .
+
+# Build the application
+RUN go build -ldflags="-s -w" -o server .
+
+FROM alpine:latest
+
+WORKDIR /app
+
+# Copy the built binary from the builder stage
+COPY --from=builder /app/server ./
+
+# The container will run the JavaScript executor MCP server
+ENTRYPOINT ["./server"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Anthropic, PBC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,146 @@
+# JavaScript Executor MCP Server
+
+This MCP server provides JavaScript execution capabilities with a Node.js-like environment.
+
+## Features
+
+The `executeJS` tool provides:
+
+- **Console API**: `console.log()`, `console.error()`, `console.warn()`
+- **File System**: `fs.readFileSync()`, `fs.writeFileSync()`, `fs.existsSync()`
+- **HTTP Server**: `http.createServer()` with request/response handling
+- **Timers**: `setTimeout()`, `clearTimeout()`, `setInterval()`, `clearInterval()`
+- **Process**: `process.argv`, `process.cwd()`, `process.exit()`, `process.env`
+- **Module System**: `require()` for loading JavaScript modules
+
+## Getting Started
+
+### Installation
+
+#### Using Go Install
+
+```bash
+go install github.com/mark3labs/codebench-mcp@latest
+```
+
+### Usage
+
+#### As a standalone server
+
+```bash
+codebench-mcp
+```
+
+#### As a library in your Go project
+
+```go
+package main
+
+import (
+	"log"
+
+	"github.com/mark3labs/codebench-mcp/jsserver"
+	"github.com/mark3labs/mcp-go/server"
+)
+
+func main() {
+	// Create a new JavaScript executor server
+	jss, err := jsserver.NewJSServer()
+	if err != nil {
+		log.Fatalf("Failed to create server: %v", err)
+	}
+
+	// Serve requests
+	if err := server.ServeStdio(jss); err != nil {
+		log.Fatalf("Server error: %v", err)
+	}
+}
+```
+
+### Usage with Model Context Protocol
+
+To integrate this server with apps that support MCP:
+
+```json
+{
+  "mcpServers": {
+    "javascript": {
+      "command": "codebench-mcp"
+    }
+  }
+}
+```
+
+### Docker
+
+#### Running with Docker
+
+You can run the JavaScript Executor MCP server using Docker:
+
+```bash
+docker run -i --rm ghcr.io/mark3labs/codebench-mcp:latest
+```
+
+#### Docker Configuration with MCP
+
+To integrate the Docker image with apps that support MCP:
+
+```json
+{
+  "mcpServers": {
+    "javascript": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "ghcr.io/mark3labs/codebench-mcp:latest"
+      ]
+    }
+  }
+}
+```
+
+## Tool Reference
+
+### executeJS
+
+Execute JavaScript code with full Node.js-like environment.
+
+**Parameters:**
+- `code` (required): JavaScript code to execute
+
+**Example:**
+```javascript
+console.log("Hello, World!");
+
+// File operations
+fs.writeFileSync("test.txt", "Hello from JS!");
+const content = fs.readFileSync("test.txt");
+console.log("File content:", content);
+
+// HTTP server
+const server = http.createServer((req, res) => {
+  res.end("Hello from HTTP server!");
+});
+server.listen(8080);
+
+// Timers
+setTimeout(() => {
+  console.log("Timer executed!");
+}, 1000);
+
+// Process info
+console.log("Current directory:", process.cwd());
+console.log("Arguments:", process.argv);
+```
+
+## Building
+
+```bash
+go build -o codebench-mcp .
+```
+
+## License
+
+See the [LICENSE](LICENSE) file for details.