快聊AI MCP服务器

关键词

AI智能体集成工具第三方AI应用快速聊天智能体交互

项目简介

Quickchat AI MCP 服务器是基于 Model Context Protocol (MCP) 实现的应用后端，旨在将你在 Quickchat AI 平台上创建的 AI 智能体（Agent）无缝集成到各种支持 MCP 协议的第三方 AI 客户端应用中，例如 Claude Desktop、Cursor 等。它充当智能体和 AI 客户端之间的桥梁，使 AI 客户端能够通过标准化的 MCP 协议与你的智能体进行通信。

主要功能点

  • 连接 Quickchat AI 智能体： 允许外部 AI 客户端应用通过 MCP 协议连接并与你在 Quickchat AI 平台配置的智能体进行交互。
  • 代理消息交互： 负责接收来自 AI 客户端的消息请求，将其转发到 Quickchat AI 智能体处理，并将智能体的回复返回给客户端。
  • 声明智能体能力： 根据 Quickchat AI 平台上的配置，向连接的 AI 客户端声明智能体的特定能力或命令，使得客户端可以识别并调用这些功能。
  • 会话状态管理： 维护与不同智能体实例相关的会话 ID，确保消息在正确的会话上下文中传递。

安装步骤

该项目作为一个可执行的包发布到 PyPI，可以通过 'uv' 工具轻松安装和运行。

  1. 安装 'uv': 如果你尚未安装 'uv'，请运行以下命令或参考 'uv' 的官方文档进行安装： 
    curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 安装 'quickchat-ai-mcp': 使用 'uv' 安装项目包： 
    uv pip install quickchat-ai-mcp
    这将安装 quickchat-ai-mcp 包及其所有依赖项。

服务器配置

MCP 服务器通常由支持 MCP 的 AI 客户端应用直接启动和管理。你需要将 Quickchat AI MCP 服务器的启动信息添加到你的 AI 客户端应用的配置中。配置通常是一个 JSON 格式的代码段，包含服务器的名称、启动命令、参数以及必要的环境变量。

以下是一个典型的配置示例（具体的字段名和结构可能因 AI 客户端应用而异）：

{
  "mcpServers": {
    "你在Quickchat AI平台设置的MCP名称": {
      "command": "uvx", // 启动 MCP 服务器的可执行命令
      "args": ["quickchat-ai-mcp"], // 传递给启动命令的参数，指定运行 quickchat-ai-mcp 包
      "env": { // 启动服务器时设置的环境变量，用于传递智能体信息和密钥
        "SCENARIO_ID": "你在Quickchat AI平台获取的智能体/场景ID", // 必填，用于标识要连接的智能体
        "API_KEY": "你在Quickchat AI平台获取的API密钥" // 可选，如果智能体要求 API Key 认证，则需要此项
      }
    }
  }
}

重要提示:

  • 你需要在 Quickchat AI 平台的智能体或 MCP 设置页面找到你的智能体 ID (SCENARIO_ID) 和可选的 API Key。
  • 在 Quickchat AI 平台设置 MCP 时，你可以定义 MCP 的名称和描述，这些信息将被服务器用于向客户端声明自身。
  • 如果你的智能体不需要 API Key (可在 Quickchat AI 平台设置)，则在配置中无需包含 '"API_KEY": "..."' 这一行。
  • 请参考你使用的 AI 客户端应用的文档，了解如何添加和配置 MCP 服务器。

基本使用方法

  1. 在 Quickchat AI 平台配置智能体和 MCP： 登录 Quickchat AI 平台，创建并配置你的 AI 智能体。然后在 MCP 设置页面激活并配置 MCP，包括 MCP 名称、描述和可选的命令（将作为客户端调用智能体的工具名称），并获取智能体 ID (SCENARIO_ID) 和 API Key (如果需要)。
  2. 配置 AI 客户端应用： 打开你选择的 AI 客户端应用（如 Claude Desktop, Cursor 等），找到其 MCP 或开发者设置。将上述提供的 MCP 服务器配置信息填入相应的设置区域，确保包含正确的 MCP 名称、'command' ('uvx')、'args' ('quickchat-ai-mcp') 以及 'env' 中你的 SCENARIO_ID 和 API_KEY (如果需要)。
  3. 连接与交互： 保存配置并根据客户端应用的指示操作（可能需要重启应用或刷新连接）。客户端应用将启动 Quickchat AI MCP 服务器，并根据服务器声明的能力（由你在 Quickchat AI 平台配置的 MCP 命令决定）允许你与智能体进行交互。你现在可以在 AI 客户端中通过调用该命令来向你的 Quickchat AI 智能体发送消息并接收回复。

服务器信息

访问项目