Bmorphism Babashka MCP Server

🚀 Babashka MCP Server

A Model Context Protocol (MCP) server for interacting with Babashka, a native Clojure interpreter for scripting.

✨ Features

• Execute Babashka code via MCP tools.
• Cache the results of recent commands.
• Access command history through MCP resources.
• Configure command timeout.

📦 Installation Guide

Prerequisites: Install Babashka

Babashka can be installed in multiple ways:

macOS

brew install borkdude/brew/babashka

Linux

bash < <(curl -s https://raw.githubusercontent.com/babashka/babashka/master/install)

Windows

# Install using scoop
scoop install babashka

For other installation methods, refer to the official Babashka installation guide.

Verify the Installation

After installation, verify that Babashka is working properly:

# Check the version
bb --version

# Test a simple expression
bb -e '(+ 1 2 3)'

# Run a script passed as a string
bb -e '(defn hello [x] (str "Hello, " x "!")) (hello "World")'

# Process input lines using the -i flag
ls | bb -i '(take 2 *input*)'

Install the Server

# Install dependencies
npm install

# Build the MCP server
npm run build

📚 Documentation

Configuration

The server can be configured via environment variables:

• BABASHKA_PATH: The path to the Babashka executable (default: "bb")

Tools

execute

Execute Babashka code with an optional timeout:

{
  name: "execute",
  arguments: {
    code: string;      // Babashka code to execute
    timeout?: number;  // Timeout in milliseconds (default: 30000)
  }
}

Example:

{
  name: "execute",
  arguments: {
    code: "(+ 1 2 3)",
    timeout: 5000
  }
}

Resources

The server maintains a cache of recent command execution results, which can be accessed as follows:

• babashka://commands/{index} - Access the result of a specific command by index

Babashka Language Features

Tail Call Optimization (TCO)

Babashka supports explicit tail call optimization via the recur special form but does not support automatic TCO. For example:

;; This will cause a stack overflow
(defn countdown [n]
  (if (zero? n)
      "done"
      (recur (- n 1))))

;; Supported implementation
(defn countdown [n]
  (loop [n n]
    (when (> n 0)
      (println n)
      (recur (- n 1)))))

📄 References

For more information about the MCP protocol and Babashka, refer to:

• Official MCP documentation
• Official Babashka website

If you encounter issues or have suggestions for improvement, please contact us via:

• Email: support@babashka-project.org
• Forum: Babashka User Forum