Happy slice of mcp pizzaMCP.pizza

amazon-bedrock-client-for-mac

MCP.Pizza Chef: aws-samples

Amazon Bedrock Client for Mac is a modern, native macOS application designed to provide streamlined and direct access to Amazon Bedrock's AI models from your desktop environment. Built with Swift 5.9, it offers a smooth, efficient interface for developers and users to interact with powerful AI capabilities without leaving macOS. This client simplifies integration with Amazon Bedrock, enhancing productivity and enabling real-time AI model usage in a familiar desktop setting. It supports secure, fast, and native interactions tailored for macOS users.

Use This MCP client To

Access Amazon Bedrock AI models from macOS desktop Integrate AI model calls into macOS workflows Test and prototype AI interactions locally on Mac Streamline AI development with native macOS tools Manage AI model requests securely on Mac

README

Amazon Bedrock Client for Mac

Amazon Bedrock Client for Mac

Latest Release Build Status License: MIT-0 Platform Swift Version

A modern, native macOS client for Amazon Bedrock, providing streamlined access to AI models directly from your desktop.

Download • Features • Getting Started • Usage • Troubleshooting • Contributing

Features

Model Support

  • Full access to Amazon Bedrock models including Claude 3.7 Sonnet, Llama, Mistral, DeepSeek R1, and Stable Diffusion
  • Support for text generation, image generation, and embedding models
  • Multi-modal capabilities with image upload for Claude 3 models
  • Model Context Protocol (MCP) integration with tool use tracking and execution
  • Enhanced reasoning capabilities with increased token budget (2048 tokens)

User Experience

  • Clean, native macOS interface with dark mode support
  • Real-time streaming responses with Claude 3.7 thinking support
  • Message history and conversation management
  • In-chat search functionality (Cmd+F)
  • Real-time voice transcription
  • Keyboard shortcuts for font size adjustment, navigation, and sidebar toggle
  • Consistent styling and animations across all views

Document & Media Management

  • Expanded functionality to handle both images and documents
  • Document attachment support (PDF, Word, etc.) with proper rendering
  • Modern image viewer modal
  • Image compression and optimization utilities

Developer Features

  • AWS SSO and credential profile support
  • Multi-region capabilities
  • Custom system prompts and model parameters
  • Code generation with syntax highlighting
  • Unified ConverseStream API for all text generation models

Download

Get the latest version:

Download Latest Release

Homebrew Installation

You can also install using Homebrew:

# Add the tap
brew tap didhd/tap
brew update

# Install Amazon Bedrock Client
brew install amazon-bedrock-client --no-quarantine

Getting Started

Requirements

  • macOS 14 or later
  • AWS Account with Bedrock access
  • Configured AWS credentials

Installation

  1. Download and open the DMG file
  2. Drag the app to your Applications folder
  3. Launch the app and configure your AWS settings (ensure ~/.aws/credentials and ~/.aws/config are properly set up with your access keys or SSO configuration)

IMPORTANT: When opening for the first time, macOS security features will block the application. You'll need to approve it manually in System Preferences > Privacy & Security by clicking "Open Anyway".

Security approval dialog

Usage

Basic Operation

  1. Select your desired model from the dropdown
  2. Type your message or query
  3. Press Enter or click send
  4. View the AI's response in the conversation view

Advanced Features

  • Search: Use Cmd+F to search through conversation history
  • Voice Input: Click the microphone for speech-to-text
  • Image Upload: Use the image button for visual inputs (Claude 3)
  • Document Upload: Attach PDFs and other document formats
  • Model Settings: Configure system prompts and parameters
  • AWS Profiles: Switch between different credential profiles
  • Sidebar Toggle: Use keyboard shortcut to show/hide sidebar

Troubleshooting

For common issues and solutions, see our Troubleshooting Guide.

Common Issues

  • AWS credential recognition problems
  • Model access permissions
  • Image generation formatting requirements
  • Nova models compatibility (fixed in v1.2.11)

Contributing

We welcome contributions from the community:

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request

License

Licensed under the MIT License - see the LICENSE file for details.

Star History

Star History Chart

Developed by the AWS Community

amazon-bedrock-client-for-mac FAQ

How do I install the Amazon Bedrock Client for Mac?
Download the latest release from the GitHub repository's releases page and follow the installation instructions provided in the README file.
Is the Amazon Bedrock Client for Mac open source?
Yes, it is open source under the MIT-0 license, allowing free use and modification.
What programming language is used to build this client?
The client is built using Swift 5.9, optimized for native macOS performance.
Can I use this client with other LLM providers besides Amazon Bedrock?
This client is specifically designed for Amazon Bedrock, but MCP architecture allows integration with other providers like OpenAI, Anthropic, Claude, and Gemini through different clients.
Does the client support secure authentication?
Yes, it supports secure authentication mechanisms to safely connect to Amazon Bedrock services.
Is the client compatible with all macOS versions?
It is designed for modern macOS versions; check the GitHub repository for specific compatibility details.
How can I contribute to the development of this client?
Contributions are welcome via GitHub by submitting issues or pull requests following the contribution guidelines.
Does the client provide a graphical user interface?
Yes, it offers a native macOS GUI for easy interaction with Amazon Bedrock AI models.