Scira MCP 聊天

一款由 Model Context Protocol (MCP) 驱动的开源 AI 聊天机器人应用，基于 Next.js 和 Vercel 的 AI SDK 构建。

功能 • MCP 服务器配置 • 许可证

功能

• 基于 Vercel 的 AI SDK 的流式文本响应，只需几行代码即可轻松切换不同的 AI 提供商。
• 与 Model Context Protocol (MCP) 服务器完全集成，以扩展可用工具和功能。
• 支持 HTTP 和 SSE 传输协议，用于连接各种 MCP 工具提供商。
• 内置工具集成，可进一步增强 AI 能力。
• 支持推理模型。
• 使用 shadcn/ui 组件，并由 Tailwind CSS 提供支持，打造现代化、响应式的用户界面。
• 基于最新的 Next.js 应用程序路由构建。

MCP 服务器配置

本应用支持连接到 Model Context Protocol (MCP) 服务器以访问其提供的工具。您可以通过聊天界面中的设置图标添加和管理 MCP 服务器。

添加 MCP 服务器

1. 点击聊天界面中模型选择器旁边的设置图标（⚙️）。
2. 为您的 MCP 服务器输入一个名称。
3. 选择传输类型：
   • HTTP：适用于基于 HTTP 的远程服务器。
   • SSE（服务器发送事件）：适用于基于 SSE 的远程服务器。

HTTP 或 SSE 配置

1. 输入服务器 URL（例如：https://mcp.example.com/mcp 或 https://mcp.example.com/token/sse）。
2. 点击“添加服务器”。
3. 点击“启用服务器”，以在当前聊天会话中激活该服务器。

可用的 MCP 服务器

您可以使用任何兼容 MCP 的服务器与本应用配合使用。以下是一些示例：

• Composio - 提供搜索、代码解释器等工具。
• Zapier MCP - 提供对 Zapier 工具的访问权限。
• Hugging Face MCP - 提供对 Hugging Face Hub 工具的访问权限。
• 任何兼容 HTTP 或 SSE 传输协议的 MCP 服务器。

许可证

本项目采用 Apache License 2.0 许可证授权——详情请参阅 LICENSE 文件。

Scira MCP Chat 快速上手指南

Scira MCP Chat 是一款基于 Model Context Protocol (MCP) 的开源 AI 聊天应用，采用 Next.js 和 Vercel AI SDK 构建。它支持流式响应、多种 AI 提供商切换，并能通过 HTTP 或 SSE 协议连接各类 MCP 服务器以扩展工具能力。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux
• Node.js：版本 18.17 或更高（推荐使用 LTS 版本）
• 包管理器：npm, yarn, pnpm 或 bun
• 代码编辑器：推荐 VS Code

前置依赖检查：

node -v
npm -v

安装步骤

1. 克隆项目仓库

   git clone https://github.com/scira-ai/scira-mcp-chat.git
   cd scira-mcp-chat
   

2. 安装依赖 国内开发者如遇网络延迟，可配置淘宝镜像源加速安装：

   # 使用 npm 并指定 registry
   npm install --registry=https://registry.npmmirror.com
   
   # 或者如果您使用 pnpm
   pnpm install --registry=https://registry.npmmirror.com
   

3. 配置环境变量 复制示例环境变量文件并根据需要修改（主要需配置您的 AI Provider API Key）：

   cp .env.example .env.local
   

   编辑 .env.local 文件，填入相应的 API 密钥（如 OPENAI_API_KEY 等）。

4. 启动开发服务器

   npm run dev
   

   应用将在 http://localhost:3000 运行。

基本使用

启动应用后，您即可在浏览器中体验核心功能。以下是连接 MCP 服务器扩展能力的最简流程：

1. 进入聊天界面 打开浏览器访问 http://localhost:3000，选择您想要使用的 AI 模型。

2. 添加 MCP 服务器

   • 点击聊天界面模型选择器旁边的 设置图标 (⚙️)。
   • 输入服务器名称（例如：Composio Tools）。
   • 选择传输类型：
     • HTTP：适用于基于 HTTP 的远程服务器。
     • SSE (Server-Sent Events)：适用于基于 SSE 的远程服务器。
   • 输入服务器 URL（例如：https://mcp.example.com/mcp）。
   • 点击 "Add Server"。

3. 启用并测试

   • 在列表中找到刚添加的服务器，点击 "Enable Server" 以在当前会话中激活它。
   • 现在，您可以在对话框中直接使用与该 MCP 服务器关联的工具（如搜索、代码解释器、Zapier 自动化等）。

示例场景： 若已启用 Composio MCP 服务器，您可以直接询问：“帮我查询最新的科技新闻”或“运行这段 Python 代码”，AI 将自动调用后端工具执行任务并返回结果。