# dolphin-mcp

> MCP Client

Dolphin MCP is a Python library and CLI tool for interacting with Model Context Protocol servers using natural language. It supports multiple LLMs and provides a conversational interface for accessing

## Overview

- **Category:** AI
- **Language:** Python
- **Stars:** 532
- **Forks:** 29
- **Owner:** cognitivecomputations
- **GitHub:** https://github.com/cognitivecomputations/dolphin-mcp
- **Created:** 2025-03-11T17:13:44+00:00
- **Updated:** 2025-03-28T20:22:54+00:00
- **Source:** https://model-context-protocol.com/clients/python-llm-model-context-protocol-tool

## Setup

## Setup

Before installing Dolphin MCP, ensure you have the following prerequisites installed:

1. **Python 3.8+**
2. **SQLite** - A lightweight database used by the demo
3. **uv/uvx** - A fast Python package installer and resolver

### Setting up Prerequisites

#### Windows

1. **Python 3.8+**:
   - Download and install from [python.org](https://www.python.org/downloads/windows/)
   - Ensure you check "Add Python to PATH" during installation
2. **SQLite**:
   - Download the precompiled binaries from [SQLite website](https://www.sqlite.org/download.html)
   - Choose the "Precompiled Binaries for Windows" section and download the sqlite-tools zip file
   - Extract the files to a folder (e.g., `C:\sqlite`)
   - Add this folder to your PATH:
     - Open Control Panel > System > Advanced System Settings > Environment Variables
     - Edit the PATH variable and add the path to your SQLite folder
     - Verify installation by opening Command Prompt and typing `sqlite3 --version`
3. **uv/uvx**:
   - Open PowerShell as Administrator and run:
     ```
     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     ```
   - Restart your terminal and verify installation with `uv --version`

#### macOS

1. **Python 3.8+**:
   - Install using Homebrew:
     ```
     brew install python
     ```
2. **SQLite**:
   - SQLite comes pre-installed on macOS, but you can update it using Homebrew:
     ```
     brew install sqlite
     ```
   - Verify installation with `sqlite3 --version`
3. **uv/uvx**:
   - Install using Homebrew:
     ```
     brew install uv
     ```
   - Or use the official installer:
     ```
     curl -LsSf https://astral.sh/uv/install.sh | sh
     ```
   - Verify installation with `uv --version`

#### Linux (Ubuntu/Debian)

1. **Python 3.8+**:
   ```
   sudo apt update
   sudo apt install python3 python3-pip
   ```
2. **SQLite**:
   ```
   sudo apt update
   sudo apt install sqlite3
   ```
   - Verify installation with `sqlite3 --version`
3. **uv/uvx**:
   ```
   curl -LsSf https://astral.sh/uv/install.sh | sh
   ```
   - Verify installation with `uv --version`

## Installation

### Option 1: Install from PyPI (Recommended)

```bash
pip install dolphin-mcp
```

This will install both the library and the `dolphin-mcp-cli` command-line tool.

### Option 2: Install from Source

1. Clone this repository:
   ```bash
   git clone https://github.com/cognitivecomputations/dolphin-mcp.git
   cd dolphin-mcp
   ```
2. Install the package in development mode:
   ```bash
   pip install -e .
   ```
3. Set up your environment variables by copying the example file and adding your OpenAI API key:
   ```bash
   cp .env.example .env
   ```
   Then edit the `.env` file to add your OpenAI API key.
4. (Optional) Set up the demo dolphin database:
   ```bash
   python setup_db.py
   ```
   This creates a sample SQLite database with dolphin information that you can use to test the system.

## Tools

## Available Tools

1.  **Multiple Provider Support** (Works with OpenAI, Anthropic, Ollama, and LMStudio models)
2.  **Modular Architecture** (Clean separation of concerns with provider-specific modules)
3.  **Dual Interface** (Use as a Python library or command-line tool)
4.  **MCP Server Integration** (Connect to any number of MCP servers simultaneously)
5.  **Tool Discovery** (Automatically discover and use tools provided by MCP servers)
6.  **Flexible Configuration** (Configure models and servers through JSON configuration)
7.  **Environment Variable Support** (Securely store API keys in environment variables)
8.  **Comprehensive Documentation** (Detailed usage examples and API documentation)
9.  **Installable Package** (Easy installation via pip with `dolphin-mcp-cli` command)