Babashka MCP Server

1 forks

2 stars

Free

What is babashka-mcp-server

babashka-mcp-server is a powerful Model Context Protocol (MCP) server developed by bmorphism, designed to facilitate seamless interactions with Babashka. Babashka is a native Clojure interpreter aimed at making scripting easier and more efficient. This server acts as a bridge, allowing users to execute Babashka scripts through MCP tools, providing a robust platform for integrating Babashka's capabilities within a broader AI ecosystem. By leveraging the universal MCP standard, babashka-mcp-server empowers users to securely connect AI systems to various data sources and tools, enhancing the automation and scripting capabilities of Babashka.

How to Use babashka-mcp-server

To start using babashka-mcp-server, you need to have Babashka installed on your system. This can be done easily through package managers like Homebrew for macOS, direct script installation for Linux, or Scoop for Windows. Once Babashka is set up, you can verify its installation by running simple commands to check the version and execute basic scripts.

After setting up Babashka, install the necessary dependencies for the server using npm, then build the server with a simple npm command. Configuration of the server is flexible and can be adjusted through environment variables, such as setting the path to the Babashka executable.

To execute Babashka code, you can use the execute tool provided by the server. This allows you to run scripts with an optional timeout, giving you control over how long a command should execute before being terminated. The server also maintains a cache of recent command executions, which can be accessed for reviewing past results.

Key Features of babashka-mcp-server

Execute Babashka Code: Run your Babashka scripts directly through the server using MCP tools, making it easy to automate and script tasks.
Cache and History: The server caches recent command results and maintains a history of executed commands. This makes it easy to review past executions and reuse commands as needed.
Configurable Timeouts: Set time limits on command execution to ensure scripts do not run indefinitely, providing control and management over script execution.
Flexible Configuration: Easily configure the server with environment variables to suit your specific needs, such as adjusting the path to the Babashka executable.
Development Roadmap: The server is continually evolving, with plans to become self-hosting by rewriting in Babashka, enhancing performance, and adding new features like file watching and REPL integration.

babashka-mcp-server is a versatile and powerful tool for anyone looking to integrate Babashka scripting into their workflows, offering a robust platform for executing and managing scripts efficiently and securely. Whether you're a seasoned developer or a scripting novice, this server provides the tools you need to enhance your automation capabilities.

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

Features

Execute Babashka code through MCP tools
Cache recent command results
Access command history through MCP resources
Configurable command timeouts

Prerequisites

Install Babashka

Babashka can be installed in several ways:

macOS

brew install borkdude/brew/babashka

Linux

bash < <(curl -s )

Windows

# Using scoop
scoop install babashka

For other installation methods, see the official Babashka installation guide.

Verify Installation

After installation, verify Babashka works:

# Check version
bb --version
# Try a simple expression
bb -e '(+ 1 2 3)'
# Run a script from string
bb -e '(defn hello [x] (str "Hello, " x "!")) (hello "World")'
# Use -i flag to process lines of input
ls | bb -i '(take 2 *input*)'

Installation

# Install dependencies
npm install
# Build the MCP server
npm run build

Configuration

The server can be configured through environment variables:

BABASHKA_PATH: Path to the Babashka executable (default: "bb")

Tools

execute

Execute Babashka code with 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 executions accessible through:

babashka://commands/{index} - Access specific command results by index

Babashka Language Features

Tail Call Optimization (TCO)

Babashka supports explicit tail call optimization through the recur special form, but does not implement automatic TCO. For example:

;; This will cause stack overflow
(defn countdown [n]
 (if (zero? n)
 :done
 (countdown (dec n))))
;; This works with TCO using recur
(defn countdown [n]
 (if (zero? n)
 :done
 (recur (dec n))))

Useful Resources

Official Resources

Babashka GitHub Repository - The main Babashka project
Babashka Book - Official documentation
Babashka Examples - Collection of example scripts

Community Tools & Libraries

pod-babashka-buddy - Cryptographic API for Babashka
bb-clis - Collection of useful Babashka CLI scripts
bb-scripts - Various utility scripts for Babashka

Development Tools

setup-babashka - GitHub Actions for installing Babashka
babashka-docker-action - Run Babashka scripts in GitHub Actions

Development

This server is designed to eventually become self-hosting, meaning it will be rewritten in Babashka itself. The current TypeScript implementation serves as a reference and starting point.

Roadmap

Self-Hosted Implementation

Rewrite the MCP server in Babashka
Leverage Babashka's native capabilities for better performance
Remove Node.js dependency
Maintain full compatibility with MCP protocol
Support all current features:
Command execution
Resource management
Command history
Timeout handling

Enhanced Features

Add support for Babashka pods
Implement file watching capabilities
Add REPL integration
Support for multiple Babashka instances

Performance Optimizations

Implement caching strategies
Optimize resource usage
Reduce startup time

Testing & Documentation

Comprehensive test suite
API documentation
Usage examples
Performance benchmarks

How to Use

To use the babashka-mcp-server, follow these steps:

Visit https://github.com/bmorphism/babashka-mcp-serverhttps://github.com/bmorph...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using babashka-mcp-server capabilities within your Claude conversations

Additional Information

Created

January 5, 2025

Company

bmorphism

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More