spring-ai-playground

Overview

Spring AI Playground is a comprehensive desktop application that provides a safe local execution layer for AI agent tools. It features a 'no-pass-no-run' workflow where tools must pass local testing before being exposed to MCP servers. The app includes 86 default tools across various categories and supports both HTTP and stdio MCP server modes. Built with Spring Boot, it works across macOS, Windows, and Linux without requiring Java development knowledge.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• web_fetch

  Fetch web content from URLs

  Try:Fetch content from this URLTry:Get the text from https://example.com
• datetime

  Get current date and time information

  Try:What's the current time?Try:Get today's date in ISO format
• math

  Perform mathematical calculations

  Try:Calculate 15% of 200Try:What is the square root of 64?
• crypto

  Encrypt and decrypt data

  Try:Encrypt this messageTry:Decode this base64 string
• filesystem

  Access and manipulate files and directories

  Try:List files in this directoryTry:Create a new text file
• github

  Interact with GitHub repositories

  Try:Create a new GitHub issueTry:Get latest commits from repo
• wikipedia

  Search and retrieve information from Wikipedia

  Try:Find information about AITry:Get summary of quantum computing
• weather

  Get weather information for locations

  Try:What's the weather like in Tokyo?Try:Check if it will rain tomorrow in London
• finance

  Access financial data and calculations

  Try:Get stock price for AAPLTry:Convert USD to EUR
• geo

  Get geographic information and services

  Try:Find coordinates for ParisTry:Calculate distance between two cities
• security

  Perform security-related operations

  Try:Generate a secure passwordTry:Check password strength
• encoding

  Encode and decode various formats

  Try:Encode text to Base64Try:Decode URL-encoded string

Comparable tools

Installation

docker run -p 8282:8282 -v spring-ai-playground:/root ghcr.io/spring-ai-community/spring-ai-playground

{
  "mcpServers": {
    "spring-ai-playground": {
      "command": "java",
      "args": ["-jar", "path/to/spring-ai-playground.jar", "--spring.profiles.active=mcp-stdio"]
    }
  }
}

FAQ

What is the 'no-pass-no-run' workflow?

It's a safety feature where tools must pass a local test run with sample arguments before being exposed to the MCP server and made available to AI agents.

Does this require Java knowledge to use?

No, the desktop app is designed for non-Java developers. You only need to be able to write small JavaScript functions to build tools.

How are API keys and secrets managed?

The app provides secure secret management through the desktop interface with OS-backed secure storage when available, falling back to encrypted local storage otherwise.

On Hacker News

Recent discussion from the developer community.

• Show HN: Spring AI Playground – No-code MCP tool studio and agentic chat▲ 1💬 1
  Story by hjm1980 · 2025-12-22
• Show HN: I built a desktop app for building and debugging MCP tools▲ 1
  Story by hjm1980 · 2026-04-09

Compare spring-ai-playground with