Repolode
QuixiAI

QuixiAI/dolphin-mcp

一个 Python 库和命令行工具,让 OpenAI、Anthropic、Ollama、LMStudio 等模型通过自然语言调用 MCP 服务器上的工具。

Star
533
Fork
59
未关闭 Issue
18
最近提交
23天前

这是什么?

Dolphin MCP 是一个 Python 库和命令行工具,用于通过自然语言查询 Model Context Protocol(MCP)服务器。它可以同时连接多个已配置的 MCP 服务器,获取各服务器提供的工具,并把这些工具交给语言模型,让模型在回答问题时调用它们。

目前支持 OpenAI、Anthropic、Ollama 和 LMStudio 四类模型提供方。MCP 服务器通过 JSON 文件配置启动命令、参数和环境变量,API 密钥则从 .env 文件读取。命令行支持单次提问、保留上下文的交互式对话,并可把所有 LLM 交互记录到 JSONL 文件。

项目可通过 PyPI 安装,并提供 dolphin-mcp-cli 命令。仓库还附带一个基于 SQLite 的演示 MCP 服务器和海豚物种示例数据库。

核心功能

  • 01可同时连接多个 MCP 服务器,并将其全部工具提供给模型。
  • 02支持 OpenAI、Anthropic、Ollama 和 LMStudio 模型。
  • 03同时提供 Python 库接口和 dolphin-mcp-cli 命令行工具。
  • 04支持单次提问和保留上下文的交互式对话。
  • 05可将 LLM 交互记录到 JSONL 文件以便检查。

适用场景

  • 通过 MCP 服务器用自然语言查询数据库或其他数据源。
  • 在命令行中用不同的 LLM 提供方测试 MCP 服务器。
  • 通过库接口把 MCP 工具调用集成到 Python 应用中。
  • 结合 Ollama 或 LMStudio 本地模型使用 MCP 工具。

快速上手

  1. 1

    从 PyPI 安装该包

    pip install dolphin-mcp
  2. 2

    在 .env 文件中设置你的 OpenAI API 密钥(添加 OPENAI_API_KEY)

  3. 3

    使用问题运行命令行工具

    dolphin-mcp-cli "Your query here"

使用前须知

  • 需要 OpenAI API 密钥或其他受支持服务商的密钥,并且需要自行配置 MCP 服务器。
  • README 中的许可证部分仍是未填写的占位内容,元数据也未列出许可证。

标签

常见问题

dolphin-mcp 是什么?
一个 Python 库和命令行工具,让 OpenAI、Anthropic、Ollama、LMStudio 等模型通过自然语言调用 MCP 服务器上的工具。 Dolphin MCP 是一个 Python 库和命令行工具,用于通过自然语言查询 Model Context Protocol(MCP)服务器。它可以同时连接多个已配置的 MCP 服务器,获取各服务器提供的工具,并把这些工具交给语言模型,让模型在回答问题时调用它们。
dolphin-mcp 可以免费使用吗?用的什么许可证?
dolphin-mcp 没有声明许可证。代码虽然公开,但没有许可证就没有明确的使用授权,正式使用前建议先联系作者。
dolphin-mcp 还在维护吗?
活跃维护中。dolphin-mcp 最近一次提交是在 2026年9月29日。
dolphin-mcp 适合用来做什么?
通过 MCP 服务器用自然语言查询数据库或其他数据源。 在命令行中用不同的 LLM 提供方测试 MCP 服务器。 通过库接口把 MCP 工具调用集成到 Python 应用中。 结合 Ollama 或 LMStudio 本地模型使用 MCP 工具。
dolphin-mcp 怎么安装和运行?
从 PyPI 安装该包: pip install dolphin-mcp 在 .env 文件中设置你的 OpenAI API 密钥(添加 OPENAI_API_KEY) 使用问题运行命令行工具: dolphin-mcp-cli "Your query here"
在哪里获取 dolphin-mcp?
源代码和安装说明在 GitHub 上:https://github.com/QuixiAI/dolphin-mcp

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目