mcpField
O
Ollama MCP Client

Ollama MCP Client

github.com/georgi-terziyski编码 Agent384 周前更新

关于 Ollama MCP Client

Ollama MCP Client 使用 Ollama 提供的语言模型,以自然语言查询 Database MCP Server。它支持流式响应和多种模型,并可通过命令行参数或配置文件设置。

主要功能

  1. 01使用 Qwen、Llama 3、Mistral 或 Gemini
  2. 02流式接收模型响应
  3. 03用自然语言查询数据库
  4. 04配置模型和服务端点
  5. 05发送数据库查询和结构请求

适用场景

  1. 01用自然语言列出数据库表
  2. 02查看表的结构
  3. 03通过提问检索记录
  4. 04根据描述创建数据库表

MCP 相关

客户端连接到通过服务端 URL 指定的 Database MCP 服务,并使用 Ollama 提供的模型解析自然语言请求。

详细介绍

Ollama MCP 客户端

用于通过 Ollama 提供的大模型的 Model Context Protocol (MCP) 客户端。

功能

  • 多模型支持:支持通过 Ollama 提供的 Qwen、Llama 3、Mistral 和 Gemini 模型
  • 流式响应:大模型响应的实时流式传输
  • 数据库操作:与数据库 MCP 服务无缝集成
  • 自然语言界面:使用自然语言与数据库交互

安装

# Clone the repository
git clone <repository-url>

# Install the package
pip install -e .

快速开始

# Basic usage
mcp-ollama --model llama3 --server http://localhost:8000 "List all tables in my database"

# Specify a different Ollama server
mcp-ollama --model qwen --ollama-api http://localhost:11434 --server http://localhost:8000 "Show me the schema for the users table"

配置

客户端可以使用命令行参数或配置文件进行配置:

命令行参数
  • --model:要使用的 Ollama 模型(例如 llama3、qwen、mistral、gemini)
  • --server:数据库 MCP 服务的 URL
  • --ollama-api:Ollama API 服务的 URL(默认值:http://localhost:11434)
  • --stream:启用/禁用流式响应(默认值:true)
  • --config:配置文件的路径
配置文件

在主目录中创建 config.json 文件:

{
  "model": "llama3",
  "server": "http://localhost:8000",
  "ollama_api": "http://localhost:11434",
  "stream": true
}

使用示例

自然语言数据库查询
# List tables
mcp-ollama "What tables do I have in my database?"

# Query data
mcp-ollama "Show me all users who registered in the last month"

# Create a table
mcp-ollama "Create a new table called products with columns for id, name, price, and description"

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。