AI导哈

模型上下文协议CLI

一个协议级命令行工具，用于与模型上下文协议服务器交互，支持多种模型和提供者。

  • by gideonsuttle
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 gideonsuttle/mcp-postgres

使用说明

模型上下文协议CLI

此存储库包含一个协议级CLI，旨在与模型上下文协议服务器交互。客户端允许用户发送命令、查询数据，并与服务器提供的各种资源进行交互。

特性

  • 与MCP服务器的协议级通信。
  • 动态工具和资源勘探。
  • 支持多个提供商和模型：
    • 供应商：OpenAI、Ollama。
    • 默认型号： gpt-4o-mini 对于OpenAI， qwen2.5-coder 为了没有。

先决条件

  • Python 3.8或更高版本。
  • 必需的依赖关系（请参见 安装)
  • 如果使用ollama，您应该安装并运行ollama。
  • 如果使用openai，您应该在环境变量中设置一个api密钥（openai_api_key=yourkey）

安装

  1. 克隆存储库：
git clone https://github.com/chrishayuk/mcp-cli
cd mcp-cli
  1. 安装紫外线：
pip install uv
  1. 重新同步依赖关系 ：
uv sync --reinstall

用法

要启动客户端并与SQLite服务器交互，请运行以下命令：

uv run mcp-cli --server sqlite

命令行参数

  • --server：指定要使用的服务器配置。必修的。
  • --config-file：（可选）JSON配置文件的路径。默认为 server_config.json.
  • --provider：（可选）指定要使用的提供程序(openai 或 ollama).默认为 openai.
  • --model：（可选）指定要使用的模型。默认值取决于提供程序：
    • gpt-4o-mini 对于OpenAI来说。
    • llama3.2 为了没有。

例子

使用默认的OpenAI提供程序和模型运行客户端：

uv run mcp-cli --server sqlite

使用特定配置和Ollama提供程序运行客户端：

uv run mcp-cli --server sqlite --provider ollama --model llama3.2

交互模式

客户端支持交互模式，允许您动态执行命令。类型 help 获取可用命令列表或 quit 退出程序。

支持的命令

  • ping：检查服务器是否响应。
  • list-tools：显示可用工具。
  • list-resources：显示可用资源。
  • list-prompts：显示可用提示。
  • chat：进入交互式聊天模式。
  • clear：清除终端屏幕。
  • help：显示支持的命令列表。
  • quit/exit：退出客户端。

聊天模式

要进入聊天模式并与服务器交互，请执行以下操作：

uv运行mcp-cli服务器sqlite

在聊天模式下，您可以使用工具并交互式查询服务器。启动时指定了所使用的提供程序和型号，并显示如下：

使用提供者“ollama”和型号“llama3.2”进入聊天模式。..

使用OpenAI提供程序：

如果你想使用openai模型，你应该

  • 设置 OPENAI_API_KEY 在运行客户端之前，可以在.env中或作为环境变量。

贡献

欢迎投稿！请打开一个问题或提交一个包含您提出的更改的拉取请求。

许可证

该项目根据 MIT许可证.

相关 MCP