项目简介
console-chat-gpt 是一个基于命令行的 AI 聊天客户端,它集成了 Model Context Protocol (MCP) 服务器功能。这意味着它不仅可以作为一个独立的聊天应用与多种 AI 模型交互,还能作为 MCP 服务器,对外提供资源管理和工具执行能力,从而增强其他 MCP 客户端应用的功能。
主要功能点
- 内置 MCP 服务器: 允许注册和管理外部工具 (Tools),并提供工具调用接口,使得 LLM 客户端可以通过标准化的 MCP 协议扩展功能。
- 资源管理 (Resources): 虽然仓库信息中没有明确提及资源管理,但 MCP 服务器的定义包含此项功能,理论上具备资源托管和数据访问能力,具体实现可能需要进一步代码分析确认。
- Prompt 模板 (Prompts): 支持 Prompt 模板的定义和渲染,尽管仓库信息没有直接提及,但作为 MCP 服务器的通用功能,可能在代码中有所体现。
- 多种传输协议支持: MCP 服务器通常支持 Stdio, SSE, WebSocket 等多种协议,但此仓库作为命令行工具,主要侧重于通过标准输入输出 (Stdio) 进行交互。
- 会话管理和能力声明: MCP 服务器负责会话管理,并声明自身提供的能力(如支持的工具)。
- 集成多种 AI 模型: 客户端部分支持 OpenAI, MistralAI, Anthropic, Google AI 等多种模型,可以与这些模型进行聊天交互。
- 工具扩展: 通过 MCP 协议,允许 LLM 客户端调用服务器注册的外部工具,实现例如网页浏览、数据查询、代码执行等扩展功能。
安装步骤
- 克隆仓库:
git clone https://github.com/amidabuddha/console-chat-gpt.git - 进入目录:
cd console-chat-gpt - 安装依赖:
python3 -m pip install -r requirements.txt - 获取 API 密钥: 根据您选择的 LLM 模型,从相应的平台获取 API 密钥,例如 OpenAI, MistralAI, Anthropic 等。
- 配置 'config.toml': 首次运行时,'config.toml.sample' 会自动复制为 'config.toml'。根据提示,在 'config.toml' 文件中填入您的 API 密钥和其他配置信息。
服务器配置 (MCP 客户端配置)
对于需要连接到 'console-chat-gpt' 提供的 MCP 服务器的客户端应用,需要配置服务器的启动命令。'console-chat-gpt' 作为 Python 应用,其 MCP 服务器启动命令配置示例如下 ('mcp_config.json' 文件中 'mcpServers' 字段下配置):
{ "mcpServers": { "consoleChatGPTServer": { "command": "python3", "args": ["main.py"] } } }
配置参数说明:
- server name: 'consoleChatGPTServer' (服务器名称,客户端可自定义,用于标识不同的 MCP 服务器)
- command: '"python3"' (启动服务器的命令,这里使用 'python3' 解释器来运行 Python 脚本)
- args: '["main.py"]' (命令参数,指定要运行的 Python 脚本为 'main.py',即 'console-chat-gpt' 的主程序入口)
注意: MCP 客户端需要能够访问到 'console-chat-gpt' 仓库的 'main.py' 文件,上述配置假设客户端与服务器在同一文件系统或可以通过相对路径访问。实际部署时,请根据 'console-chat-gpt' 的部署位置调整 'command' 和 'args' 配置。
基本使用方法
- 启动 console-chat-gpt:
在命令行中运行以下命令启动 'console-chat-gpt',这将同时启动内置的 MCP 服务器:
python3 main.py - 与 AI 模型聊天: 启动后,按照命令行提示,您可以选择模型、角色等,并开始与 AI 模型进行对话。
- MCP 客户端连接 (如果需要): 如果您有其他 MCP 客户端应用,可以配置连接到 'console-chat-gpt' 提供的 MCP 服务器。客户端应用将能够发现并调用 'console-chat-gpt' 服务器注册的工具,扩展其功能。 具体工具的使用方法和功能取决于 'console-chat-gpt' 服务器端实现的工具。 请参考 'console-chat-gpt' 项目文档或代码以了解其提供的具体工具。
总结: 'console-chat-gpt' 不仅是一个 AI 聊天客户端,也是一个简易的 MCP 服务器实现,能够为其他 MCP 客户端提供工具扩展能力。通过配置正确的服务器启动命令,MCP 客户端可以连接到 'console-chat-gpt' 并利用其提供的功能。
信息
分类
AI与计算