Happy slice of mcp pizzaMCP.pizza

groq-desktop-beta

MCP.Pizza Chef: groq

Groq Desktop is a cross-platform chat client supporting MCP servers and function calling models hosted on Groq. Available for Windows, macOS, and Linux, it enables seamless integration with MCP-enabled LLMs for interactive workflows. It supports local usage with easy installation options including Homebrew for macOS, providing a robust environment for real-time model interaction and tool orchestration.

Use This MCP client To

Run local Groq-hosted LLMs with MCP function calling support Interact with MCP servers for real-time context and tool usage Develop and test MCP-enabled chat workflows on desktop Use Groq Desktop on Windows, macOS, and Linux platforms Integrate local LLMs into custom AI-enhanced applications Experiment with multi-step reasoning using MCP clients

README

Groq Desktop

Latest macOS Build

Groq Desktop features MCP server support for all function calling capable models hosted on Groq. Now available for Windows, macOS, and Linux!

Note for macOS Users: After installing on macOS, you may need to run this command to open the app:

xattr -c /Applications/Groq\ Desktop.app

Screenshot 2025-04-14 at 11 53 18 PMScreenshot 2025-04-14 at 11 53 35 PM

Unofficial Homebrew Installation (macOS)

You can install the latest release using Homebrew via an unofficial tap:

brew tap ricklamers/groq-desktop-unofficial
brew install --cask groq-desktop
# Allow the app to run
xattr -c /Applications/Groq\ Desktop.app

Features

  • Chat interface with image support
  • Local MCP servers

Prerequisites

  • Node.js (v18+)
  • pnpm package manager

Setup

  1. Clone this repository
  2. Install dependencies: 
    pnpm install
  3. Start the development server: 
    pnpm dev

Building for Production

To build the application for production:

pnpm dist

This will create installable packages in the release directory for your current platform.

Building for Specific Platforms

# Build for all supported platforms
pnpm dist

# Build for macOS only
pnpm dist:mac

# Build for Windows only
pnpm dist:win

# Build for Linux only
pnpm dist:linux

Testing Cross-Platform Support

This app now supports Windows, macOS, and Linux. Here's how to test cross-platform functionality:

Running Cross-Platform Tests

We've added several test scripts to verify platform support:

# Run all platform tests (including Docker test for Linux)
pnpm test:platforms

# Run basic path handling test only
pnpm test:paths

# If on Windows, run the PowerShell test script
.\test-windows.ps1

The testing scripts will check:

  • Platform detection
  • Script file resolution
  • Environment variable handling
  • Path separators
  • Command resolution

Configuration

In the settings page, add your Groq API key:

{
  "GROQ_API_KEY": "your-api-key-here"
}

You can obtain a Groq API key by signing up at https://console.groq.com.

groq-desktop-beta FAQ

How do I install Groq Desktop on macOS?
You can install it via the official GitHub releases or use the unofficial Homebrew tap for easy installation.
What platforms does Groq Desktop support?
Groq Desktop supports Windows, macOS, and Linux operating systems.
Do I need to run any special commands after installing on macOS?
Yes, you may need to run 'xattr -c /Applications/Groq\ Desktop.app' to allow the app to open.
Can Groq Desktop interact with models other than Groq-hosted ones?
Groq Desktop is designed primarily for Groq-hosted models with MCP function calling support.
Is Groq Desktop open source?
Yes, the source code is available on GitHub under the groq-desktop-beta repository.
Does Groq Desktop support function calling in MCP?
Yes, it supports all function calling capable models hosted on Groq.
Can I use Groq Desktop to develop custom MCP workflows?
Yes, it is suitable for developing and testing MCP-enabled chat workflows locally.