关键词

AI聊天工具集成可扩展开发者本地部署

项目简介

MCP Client Chatbot 是一个聊天应用程序，旨在方便用户通过 Model Context Protocol (MCP) 协议连接和使用各种AI工具，并集成了多个流行的AI模型提供商，如 OpenAI、Anthropic、Google 和 Ollama 等。 本项目特别之处在于，它不仅是一个客户端应用，还内置了一个可定制的 MCP 服务器，允许开发者轻松地添加和管理自己的AI工具。

主要功能点

  • 多模型支持: 支持多种主流AI模型提供商，方便用户选择和使用不同的语言模型。
  • MCP工具集成: 通过 MCP 协议连接和利用各种AI工具，扩展聊天机器人的能力。
  • 内置可定制MCP服务器: 项目包含一个预配置的 MCP 服务器，开发者可以根据需要自定义和扩展工具。
  • 易于安装和部署: 使用 Next.js 和 Vercel AI SDK 等现代技术栈开发，易于本地环境或个人服务器部署，无需复杂的配置。
  • 文件配置管理: 通过文件 (mcp.config.json) 或用户界面管理 MCP 服务器配置，简化工具的添加和实验过程。

安装步骤

  1. 安装 pnpm: 推荐使用 pnpm 作为包管理器。如果尚未安装，请先安装 pnpm。 
    npm install -g pnpm
  2. 安装依赖: 克隆仓库到本地后，在项目根目录下运行以下命令安装项目依赖。 
    pnpm install
  3. 初始化项目: 运行初始化命令，这将复制 '.env.example' 文件为 '.env' 文件，并进行数据库设置。 
    pnpm initial
  4. 启动开发服务器: 运行以下命令启动本地开发服务器。 
    pnpm dev
    启动成功后，即可在浏览器中访问 'http://localhost:3000'。

服务器配置 (MCP 客户端配置)

要使 MCP Client Chatbot 连接到内置的 MCP 服务器，您需要在客户端应用中配置服务器连接信息。虽然本项目主要侧重于客户端，但为了演示 MCP 工具的功能，已经包含了一个简易的、可定制的 MCP 服务器实现 ('custom-mcp-server/index.ts')。

如果您希望客户端连接到这个内置的 MCP 服务器，您需要在 MCP 客户端的配置中添加一个服务器项。以下是连接到内置 MCP 服务器的 客户端配置 示例 (以 JSON 格式描述配置信息，用于指导 MCP 客户端配置):

{
  "servers": {
    "custom-mcp-server": { # 服务器名称，可以自定义
      "type": "stdio",    # 连接类型为 Stdio
      "command": "node",   # 启动服务器的命令
      "args": [           # 命令参数
        "custom-mcp-server/index.js"
      ]
    }
  }
}

配置参数说明:

  • 'servers': 包含所有 MCP 服务器配置的对象。
  • 'custom-mcp-server': 您为该服务器连接定义的名称，可以根据需要修改。
  • 'type': 指定 MCP 服务器的连接类型，这里使用 'stdio'，因为内置服务器使用标准输入输出进行通信。
  • 'command': 启动 MCP 服务器的命令，这里使用 'node' 来运行 JavaScript 文件。
  • 'args': 命令的参数数组，这里指定了服务器脚本的路径 'custom-mcp-server/index.js'。

请注意: 上述 JSON 配置并非直接在本项目中编辑，而是为了说明 MCP 客户端 如何配置连接到本仓库提供的 'custom-mcp-server'。 在实际的 MCP Client Chatbot 应用中，您可以通过 UI 界面或 'mcp.config.json' 文件添加和管理 MCP 服务器连接配置。 具体操作请参考项目 'README.md' 中 "Setting Up MCP Servers" 部分的说明。

基本使用方法

  1. 启动应用和 MCP 服务器: 按照安装步骤启动 MCP Client Chatbot 应用。 内置的 MCP 服务器 ('custom-mcp-server/index.ts') 需要 单独运行。 您可以在项目根目录下打开一个新的终端窗口，并执行以下命令来启动内置 MCP 服务器: 
    node custom-mcp-server/index.js
  2. 配置 MCP 服务器连接: 在 MCP Client Chatbot 应用的界面上 (通常在 '/mcp' 路径下，如 'http://localhost:3000/mcp')，根据 "服务器配置" 部分的说明，添加并配置连接到您启动的内置 MCP 服务器。
  3. 开始聊天: 配置完成后，您可以在聊天界面中使用集成了 MCP 工具的聊天功能。 例如，您可以尝试使用内置服务器提供的 'get_weather' 工具来查询天气信息。

通过以上步骤，您就可以体验 MCP Client Chatbot 如何连接和使用 MCP 服务器提供的工具，扩展 AI 聊天机器人的功能。

信息

分类

开发者工具

访问项目