Dive AI Agent

An open-source desktop application for hosting MCP servers that integrates with function-calling LLMs.

GitHub

Dive AI Agent 🤿 🤖

GitHub stars GitHub forks GitHub watchers GitHub repo size GitHub language count GitHub top language GitHub last commit Discord Twitter Follow

Dive is an open-source MCP Host Desktop Application that seamlessly integrates with any LLMs supporting function calling capabilities. ✨

Dive Demo

Table of Contents

Features 🎯

  • 🌐 Universal LLM Support: Compatible with ChatGPT, Anthropic, Ollama and OpenAI-compatible models
  • 💻 Cross-Platform: Available for Windows, MacOS, and Linux
  • 🔄 Model Context Protocol: Enabling seamless MCP AI agent integration on both stdio and SSE mode
  • ☁️ OAP Cloud Integration: One-click access to managed MCP servers via OAPHub.ai - eliminates complex local deployments
  • 🏗️ Dual Architecture: Modern Tauri version alongside traditional Electron version for optimal performance
  • 🌍 Multi-Language Support: Supports 24+ languages including English, Traditional Chinese, Simplified Chinese, Spanish, Japanese, Korean, German, French, Italian, Portuguese, Russian, Thai, Vietnamese, Filipino, Indonesian, Polish, Turkish, Ukrainian, Swedish, Norwegian, Finnish, and Lao
  • ⚙️ Advanced API Management: Multiple API keys and model switching support with model_settings.json
  • 🛠️ Granular Tool Control: Enable/disable individual MCP tools for precise customization
  • 💡 Custom Instructions: Personalized system prompts for tailored AI behavior
  • ⌨️ Keyboard Shortcuts: Comprehensive hotkey support for efficient navigation and operations (rename, settings, reload, new chat, etc.)
  • 📝 Chat Draft Saving: Automatically saves chat input drafts to prevent data loss
  • 🔄 Auto-Update Mechanism: Automatically checks for and installs the latest application updates
  • 🖥️ Command-Line Options: Support for language selection and other configurations via command-line arguments

Recent updates(2025/10/28) - v0.9.10 🎉

Latest Improvements

  • ⌨️ Hotkey Enhancements: Added new hotkeys for rename, open settings, and reload; fixed reload hotkey visibility
  • 💬 Chat Control: Fixed abort chat immediately functionality for better conversation control
  • 🛠️ Tool Management: Toggle individual tools separately without waiting for other tools to load
  • 📋 Tool Dropdown: Added convenient tool dropdown menu in chat input for quick tool selection
  • 🔍 Model List Filtering: Added provider filter for OpenRouter model list for easier model selection
  • 💾 Chat Draft Feature: Implemented automatic saving of chat input drafts to prevent data loss
  • 🔄 UI Improvements: Fixed dropdown scroll position recovery for better navigation experience
  • 📦 MCP Host Update: Bumped MCP host version for enhanced functionality and stability
  • 🏗️ CI Improvements: Disabled mss output in release builds for cleaner outputs
  • 🌐 Translation Fix: Updated translations for better localization
  • 🔧 Configuration Enhancements: Added support for OAP configuration from JSON files

Previous Updates (v0.9.9)

  • 🏪 Microsoft Store Support: Added Microsoft Store configuration and asset handling for Windows Store distribution
  • 🖼️ Image Caching Fix: Fixed issue with copying cached images in local storage
  • 🔧 Workflow Improvements: Updated GitHub release workflow for better automation
  • 📝 Settings Enhancements: Removed redundant setDefaultInstructions functionality
  • 🔄 OAP Server List Fix: Fixed duplicate page loading in OAP server list pagination
  • 🔧 Model Configuration Fixes: Fixed Anthropic model list in Tauri and corrected provider settings in advanced configuration
  • 📊 Improved Model Management: Added priority sorting for OAP models and sorted LLM models by creation time
  • 💾 Better Model Persistence: Enhanced model selection persistence across sessions and fixed auto-use of OAP models

Previous Major Changes (v0.9.5)

  • 🏗️ Dual Architecture Support: Both Electron and Tauri frameworks supported simultaneously
  • ⚡ Tauri Version: Modern architecture with optimized installer size (Windows < 30MB)
  • 🌐 OAP Platform Integration: Native support for OAPHub.ai cloud services
  • 🔐 OAP Authentication: Comprehensive login and authentication support
  • 🛠️ Granular MCP Control: Individual tool enable/disable functionality
  • 🐧 Linux Tauri Support: Full Tauri framework support on Linux platforms

Platform Availability

  • Windows: Available in both Electron and Tauri versions ✅
  • macOS: Currently Electron only 🔜
  • Linux: Available in both Electron and Tauri versions ✅

Migration Note: Existing local MCP/LLM configurations remain fully supported. OAP integration is additive and does not affect current workflows.

Download and Install ⬇️

Get the latest version of Dive: Download

Windows users: 🪟

Choose between two architectures:

  • Tauri Version (Recommended): Smaller installer (<30MB), modern architecture
  • Electron Version: Traditional architecture, fully stable
  • Python and Node.js environments will be downloaded automatically after launching

MacOS users: 🍎

  • Electron Version: Download the .dmg version
  • You need to install Python and Node.js (with npx uvx) environments yourself
  • Follow the installation prompts to complete setup

Linux users: 🐧

Choose between two architectures:

  • Tauri Version (Recommended): Modern architecture with smaller installer size
  • Electron Version: Traditional architecture with .AppImage format
  • You need to install Python and Node.js (with npx uvx) environments yourself
  • For Ubuntu/Debian users:
    • You may need to add --no-sandbox parameter
    • Or modify system settings to allow sandbox
    • Run chmod +x to make the AppImage executable
  • For Arch users:
    • If you are using Arch Linux, you can install dive using an AUR helper. For example: paru -S dive-ai

MCP Setup Options

Dive offers two ways to access MCP tools: OAP Cloud Services (recommended for beginners) and Local MCP Servers (for advanced users).

Option 1: Local MCP Servers 🛠️

For advanced users who prefer local control. The system comes with a default echo MCP Server, and you can add more powerful tools like Fetch and Youtube-dl.

Set MCP

Option 2: OAP Cloud Services ☁️

The easiest way to get started! Access enterprise-grade MCP tools instantly:

  1. Sign up at OAPHub.ai
  2. Connect to Dive using one-click deep links or configuration files
  3. Enjoy managed MCP servers with zero setup - no Python, Docker, or complex dependencies required

Benefits:

  • ✅ Zero configuration needed
  • ✅ Cross-platform compatibility
  • ✅ Enterprise-grade reliability
  • ✅ Automatic updates and maintenance

Quick Local Setup

Add this JSON configuration to your Dive MCP settings to enable local tools:

 "mcpServers":{
    "fetch": {
      "command": "uvx",
      "args": [
        "mcp-server-fetch",
        "--ignore-robots-txt"
      ],
      "enabled": true
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/files"
      ],
      "enabled": true
    },
    "youtubedl": {
      "command": "npx",
      "args": [
        "@kevinwatt/yt-dlp-mcp"
      ],
      "enabled": true
    }
  }

Using Streamable HTTP for Cloud MCP Services

You can connect to external cloud MCP servers via Streamable HTTP transport. Here's the Dive configuration example for SearXNG service from OAPHub:

{
  "mcpServers": {
    "SearXNG_MCP_Server": {
      "transport": "streamable",
      "url": "https://proxy.oaphub.ai/v1/mcp/181672830075666436",
      "headers": {
        "Authorization": "GLOBAL_CLIENT_TOKEN"
      }
    }
  }
}

Reference: @https://oaphub.ai/mcp/181672830075666436

Using SSE Server (Non-Local MCP)

You can also connect to external MCP servers (not local ones) via SSE (Server-Sent Events). Add this configuration to your Dive MCP settings:

{
  "mcpServers": {
    "MCP_SERVER_NAME": {
      "enabled": true,
      "transport": "sse",
      "url": "YOUR_SSE_SERVER_URL"
    }
  }
}

Additional Setup for yt-dlp-mcp

yt-dlp-mcp requires the yt-dlp package. Install it based on your operating system:

Windows

winget install yt-dlp

MacOS

brew install yt-dlp

Linux

pip install yt-dlp

Keyboard Shortcuts ⌨️

Dive provides comprehensive keyboard shortcuts for efficient workflow. Press ? or use the keyboard icon in the header to view all available shortcuts.

Common Shortcuts

ActionWindows/LinuxmacOS
New ChatCtrl+N⌘+N
Rename ChatCtrl+R⌘+R
Delete ChatCtrl+D⌘+D
Open SettingsCtrl+,⌘+,
Toggle SidebarCtrl+B⌘+B
Reload ApplicationCtrl+Shift+R⌘+⇧+R
Show Keyboard Shortcuts??

Note: You can view and customize keyboard shortcuts by pressing ? or clicking the keyboard icon in the application header.

Configuration ⚙️

LLM Configuration

Dive supports multiple LLM providers. Configure your API keys and models in the settings:

  1. Open Settings (Ctrl+, or ⌘+,)
  2. Navigate to LLM Configuration
  3. Add your API keys for desired providers
  4. Select your preferred model

Supported providers:

  • OpenAI (GPT-3.5, GPT-4, etc.)
  • Anthropic (Claude models)
  • Ollama (local models)
  • OpenRouter
  • AWS Bedrock
  • Mistral AI
  • Any OpenAI-compatible endpoints

MCP Configuration

MCP servers can be configured in two ways:

  1. Via UI: Navigate to Tools/MCP Manager in settings
  2. Via JSON: Edit the configuration file directly

Example configuration structure:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server-name"],
      "enabled": true
    }
  }
}

Custom Instructions

Set custom system prompts in Settings > Custom Instructions to tailor AI behavior to your needs.

Language Settings

Dive supports 24+ languages. You can:

  • Change language in Settings > General > Language
  • Auto-detect based on system locale

Build 🛠️

See BUILD.md for more details.

Contributing 🤝

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

  • 🐛 Report Bugs: Found a bug? Open an issue on our Issue Tracker
  • 💡 Suggest Features: Have ideas for new features? We'd love to hear them!
  • 🌍 Improve Translations: Help us translate Dive into more languages
  • 📝 Documentation: Help improve our documentation
  • 💻 Code Contributions: Submit pull requests with bug fixes or new features

Development Setup

  1. Fork the repository
  2. Clone your fork: git clone https://github.com/YOUR_USERNAME/Dive.git
  3. Install dependencies: npm install
  4. Start development: npm run dev (Electron) or npm run dev:tauri (Tauri)
  5. Make your changes and test thoroughly
  6. Submit a pull request

Code Standards

  • Follow the existing code style
  • Write clear commit messages
  • Add tests for new features
  • Update documentation as needed

License 📄

Dive is open-source software licensed under the MIT License.

Copyright (c) 2025 Open Agent Platform

You are free to use, modify, and distribute this software. See the LICENSE file for full details.

Connect With Us 🌐

Related Servers