问答与操作MCP客户端

一个以配置为中心、知识驱动的问答与操作MCP服务器客户端。

  • by Faheem-T
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Faheem-T/qna-action-mcp-client

使用说明

QnA动作MCP客户端

注: 该项目预计将用于: QnA动作MCP服务器

以配置为中心、知识驱动的问答和行动MCP服务器的客户端。

此应用程序提供了一个基于终端的聊天UI(TUI),用于与QnA Action MCP服务器进行交互。它利用服务器公开的意图和工具来回答问题和执行操作。

特性

  • 终端用户界面(TUI):内置 @opentui/react 以获得丰富的CLI体验。
  • 意图识别:使用意图识别代理智能地路由用户查询。
  • MCP行动支持:连接到MCP服务器以执行工具和检索资源。
  • 由Gemini提供动力:使用谷歌的Gemini模型进行理解和生成。

先决条件

设置

  1. 克隆仓库 (如果你还没有)。
  2. 安装依赖项:
    bun install
    
  3. 环境变量: 创建一个 .env 根目录中的文件,包含以下变量:
    MCP_SERVER_URL=http://localhost:3000/sse # URL to your MCP server SSE endpoint
    # GOOGLE_GENAI_API_KEY may be required depending on your Gemini SDK configuration
    
    (注: MCP_SERVER_URL 是必需的 src/utils/loadEnv.ts)

用法

启动客户端:

bun start

这将启动TUI。然后,您可以:

  • 在输入框中键入您的问题或命令。
  • 使用 Ctrl + l 切换控制台日志。
  • 使用 Tab 在输入和消息滚动框之间切换焦点。
  • 使用 Esc 将焦点返回到输入框。

建筑

客户端使用Orchestrator模式进行操作:

  1. 意向识别代理:分析用户的查询以确定意图。
  2. 主要代理人:利用连接的MCP服务器的工具和资源,根据识别的意图执行适当的操作或检索信息。

架构图