A friendly GUI for managing Claude MCP (Model Context Protocol) configurations

No more editing JSON files by hand. Connect Claude to external tools and data sources with a beautiful, intuitive interface.

MCPs for Humans transforms the way you configure Claude's MCP (Model Context Protocol) servers. Instead of manually editing JSON configuration files, you get an elegant desktop application that makes connecting Claude to external tools and data sources as simple as clicking a button.

• Beautiful, modern dark interface optimized for developer workflows
• Drag-and-drop server management
• Real-time configuration validation
• Smart command parsing with automatic quoting

• Gallery of Popular Servers: Pre-configured templates for Gmail, Google Docs, Salesforce, HubSpot, and more
• Manual Entry: Guided form interface for custom server configurations
• JSON Import/Export: Copy-paste support for existing configurations

• Test MCP configurations directly from the app
• Real-time error detection and debugging
• Detailed logs for troubleshooting
• Connection validation before saving

• Automatic configuration backup
• Version history with restore capability

• Native apps for macOS (Intel & Apple Silicon)

Get the latest version for your platform:

• Universal Binary (Intel & Apple Silicon): Download .dmg

• Node.js 16 or higher
• npm or yarn

# Clone the repository
git clone https://github.com/samlevan/mcps-for-humans.git
cd mcps-for-humans

# Install dependencies
npm install

# Run in development mode
npm run dev

npm run build

# macOS DMG (unsigned)
npm run build:mac

# macOS DMG - signed and notarized (requires Apple Developer account)
npm run build:mac:dmg

To build a signed and notarized DMG for distribution:

1. Set up your Apple Developer credentials:

   export APPLE_ID="your.email@example.com"
   export APPLE_ID_PASSWORD="xxxx-xxxx-xxxx-xxxx"  # App-specific password
   export APPLE_TEAM_ID="XXXXXXXXXX"

2. Build, sign, and notarize:

   # Build both architectures (Intel + Apple Silicon)
   npm run build:mac:dmg -- --x64 --arm64
   
   # Or build them separately
   npm run build:mac:dmg -- --x64    # Intel only
   npm run build:mac:dmg -- --arm64  # Apple Silicon only

   This will automatically:

   • Build the application for specified architecture(s)
   • Code sign with your Developer ID certificate
   • Create DMG installer(s)
   • Submit to Apple for notarization
   • Staple the notarization ticket

Note: You need an Apple Developer account and a valid Developer ID certificate installed in your Keychain.

Built applications will be saved in the dist/ directory:

• macOS: .dmg and .zip files

We welcome contributions! Whether it's:

• 🐛 Bug reports and fixes
• ✨ New feature suggestions
• 📝 Documentation improvements
• 🔌 New MCP server integrations

Please feel free to submit a Pull Request or open an issue.

MIT License - Open source. Free forever. Built with ❤️ for the Claude community.