任意のLLMモデルを使用するモデルコンテキストプロトコル(MCP)サーバーと連携するための柔軟なPythonライブラリおよびCLIツールです。

概要

Dolphin MCPはPythonライブラリであり、自然言語を通じてMCPサーバーとクエリややり取りを行うコマンドラインツールです。任意の数の設定済みMCPサーバーに接続し、それらのツールを言語モデル(OpenAI、Anthropic、Ollama、LMStudio)に提供し、これらのサーバーからデータにアクセスし操作するための会話インターフェースを提供します。

このプロジェクトは以下の方法を示しています:

• 複数のMCPサーバーに同時に接続
• これらのサーバーが提供するリストおよび呼び出しツール
• 関数呼び出し機能を活用して外部データソースとやり取りすること
• ユーザーフレンドリーな方法で結果を処理・提示する
• クリーンAPIを備えた再利用可能なPythonライブラリを作成する
• ライブラリの上にコマンドラインインターフェースを構築する

特徴

• 複数プロバイダーサポート:OpenAI、Anthropic、Ollama、LMStudioモデルに対応しています
• モジュールアーキテクチャ:プロバイダー固有のモジュールとの懸念を明確に分離
• デュアルインターフェース:Pythonライブラリまたはコマンドラインツールとしての使用

Dolphin MCP

A flexible Python library and CLI tool for interacting with Model Context Protocol (MCP) servers using any LLM model.

Overview

Dolphin MCP is both a Python library and a command-line tool that allows you to query and interact with MCP servers through natural language. It connects to any number of configured MCP servers, makes their tools available to language models (OpenAI, Anthropic, Ollama, LMStudio), and provides a conversational interface for accessing and manipulating data from these servers.

The project demonstrates how to:

• Connect to multiple MCP servers simultaneously
• List and call tools provided by these servers
• Use function calling capabilities to interact with external data sources
• Process and present results in a user-friendly way
• Create a reusable Python library with a clean API
• Build a command-line interface on top of the library

Features

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

Prerequisites

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

1. Python 3.10+
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.10+:

   • Download and install from python.org
   • Ensure you check “Add Python to PATH” during installation

2. SQLite:

   • Download the precompiled binaries from SQLite website
   • 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