关键词

MCP DaemonMCP 服务器管理工具调用资源访问后台服务

使用说明

项目简介

y-cli MCP Daemon 是 y-cli 命令行聊天应用的一个重要组成部分，它作为一个独立的后台服务运行，负责管理和维护与多个 Model Context Protocol (MCP) 服务器的连接。通过 y-cli MCP Daemon，y-cli 客户端能够以更高效和安全的方式与各种 MCP 服务器进行交互，扩展聊天应用的功能。

核心功能:

  • MCP 服务器连接管理: 集中管理 y-cli 客户端配置的多个 MCP 服务器连接，支持持久连接和会话管理。
  • 工具调用代理: 接收来自 y-cli 客户端的工具调用请求，并转发到相应的 MCP 服务器执行，简化客户端操作。
  • 资源访问代理: 支持 y-cli 客户端通过 daemon 访问 MCP 服务器托管的资源。
  • 统一接口: 为 y-cli 客户端提供统一的 JSON-RPC over Unix socket 接口，屏蔽底层 MCP 协议和多服务器的复杂性。
  • 后台运行: 作为后台服务运行，与 y-cli 客户端进程分离，提供更稳定的 MCP 服务支持。

简而言之，y-cli MCP Daemon 就像一个 MCP 服务器的“管家”，让 y-cli 客户端可以更轻松地使用各种 MCP 服务器提供的工具和资源。

主要功能点

  • 集中式 MCP 服务器管理: 通过 y-cli 命令行工具配置和管理多个 MCP 服务器的连接信息。
  • 后台服务运行: 独立于 y-cli 客户端后台运行，保持 MCP 连接的持久性。
  • Unix Socket 通信: 使用 Unix Socket 与 y-cli 客户端进行本地通信，高效安全。
  • 工具和资源代理: 代理 y-cli 客户端对 MCP 服务器工具的调用和资源的访问请求。
  • 简化客户端操作: 客户端无需直接处理 MCP 协议和多服务器连接，通过 daemon 统一接口即可使用 MCP 功能。

安装步骤

由于 y-cli MCP Daemon 是 y-cli 的一部分，您无需单独安装 daemon，只需安装 y-cli 即可。

请参考 y-cli 仓库的 README.md ⚡ Quick Start 部分进行 y-cli 的安装。

简要步骤如下：

  1. 安装 uv: 按照 uv 官方安装指南 安装 uv 工具。
  2. 安装 y-cli: 使用 uv 工具安装 y-cli： 
    uv tool install y-cli

服务器配置

y-cli MCP Daemon 本身不是一个资源或工具提供服务器，它是一个管理和连接其他 MCP 服务器的服务。因此，您需要配置的是 y-cli 客户端如何连接和使用 y-cli MCP Daemon，以及 y-cli MCP Daemon 需要连接哪些实际的 MCP 服务器。

1. 配置 MCP 服务器 (通过 y-cli 客户端):

您需要使用 'y-cli mcp add' 命令来配置 y-cli MCP Daemon 需要连接的实际 MCP 服务器。

以下是配置 MCP 服务器时需要提供的信息示例（JSON 格式描述，请勿直接复制到命令行，而是根据提示逐项输入）：

{
  "server name": "my-mcp-server",  // MCP 服务器的名称，例如 'tavily', 'todo' 等，用于在 y-cli 中引用
  "command": "npx",             // 启动 MCP 服务器的命令，例如 'node', 'python', 'uvx' 等
  "args": [                     // 启动命令的参数列表
    "-y",
    "tavily-mcp"              // 假设 tavily-mcp 是一个 MCP 服务器的 npm 包
  ],
  "env": {                      // 启动 MCP 服务器所需的环境变量
    "TAVILY_API_KEY": "your_tavily_api_key"  // 例如，tavily-mcp 可能需要 API 密钥
  }
}

配置步骤示例 (使用 'y-cli mcp add' 命令):

y-cli mcp add

然后按照提示，逐项输入 上述 JSON 配置信息中的 'Server name'、'Command'、'Arguments' 和 'Environment variables'。

注意:

  • 'command' 和 'args' 需要根据您实际使用的 MCP 服务器的启动方式进行配置。
  • 'env' 字段用于配置 MCP 服务器运行所需的环境变量，例如 API 密钥等。
  • y-cli 客户端通过配置的 'server name' 来引用不同的 MCP 服务器。

2. 启动 y-cli MCP Daemon:

配置好 MCP 服务器后，您需要启动 y-cli MCP Daemon 后台服务，才能让 y-cli 客户端连接并使用 MCP 功能。

启动 daemon 的命令是：

y-cli daemon start

基本使用方法

  1. 启动 y-cli MCP Daemon: 在终端中运行 'y-cli daemon start' 命令启动 daemon 服务。
  2. 启动 y-cli chat: 运行 'y-cli chat' 命令启动 y-cli 聊天界面。
  3. 在聊天中使用 MCP 工具: 在 y-cli 聊天界面中，您可以指示 AI 使用配置的 MCP 服务器的工具。例如，您可以输入类似 “使用 tavily 搜索今天的天气” 的指令，AI 可能会生成工具调用请求。
  4. 确认工具执行: y-cli 会提示您确认是否执行工具调用，输入 'y' 确认执行。
  5. 查看工具结果: y-cli 会显示工具执行的结果，AI 可以根据结果继续对话或完成任务。

重要提示:

  • 确保您已经配置了至少一个 MCP 服务器 (通过 'y-cli mcp add')，daemon 才能连接到实际的 MCP 服务器并提供服务。
  • 启动 daemon 服务后，保持其后台运行，y-cli 客户端才能正常使用 MCP 功能。
  • 使用 'y-cli daemon status' 命令可以查看 daemon 的运行状态和连接的 MCP 服务器。

信息

分类

开发者工具

访问项目