关键词

教育AI家庭学习上下文服务远程访问SSE

使用说明

项目简介

DadMCP 是一个基于 Model Context Protocol (MCP) 构建的远程服务器，旨在为家庭教育应用提供 AI 能力。它允许家长通过 AI 技术更有效地辅助孩子在家学习，作为一个 MCP 服务器，它主要负责托管教育资源，提供数据访问接口，并支持工具的注册和执行，以便 AI 客户端能够利用这些能力进行智能教育互动。

主要功能点

  • 资源管理与访问: 托管用于教育场景的各种资源，例如学习资料、课程内容等，并提供标准的 MCP 接口供客户端访问。
  • 工具注册与执行: 允许注册和执行与教育相关的工具，例如内容推荐、学习进度跟踪等，扩展 AI 客户端的功能。
  • Prompt 模板: 支持定义和渲染 Prompt 模板，以定制 AI 客户端与 LLM 的交互模式，优化教育内容的呈现和互动体验。
  • SSE 和 POST 传输协议: 支持 SSE (Server-Sent Events) 和 HTTP POST 协议，用于与 MCP 客户端进行双向通信，实时推送信息和处理请求。
  • 会话管理: 服务器端负责管理客户端会话，确保安全可靠的连接和数据交互。

安装步骤

  1. 安装 Supabase CLI (Beta): 按照仓库 'README.md' 指示，首先需要安装 Supabase CLI 的 Beta 版本，并启动 Supabase 本地服务。

    npx supabase@beta start

  2. 重置 Supabase (可选): 如果需要重置本地 Supabase 环境，可以运行以下命令。

    npx supabase@beta reset

  3. 生成 TypeScript 类型定义: 根据 Supabase 的 schema 生成 TypeScript 类型定义文件，这对于后续开发很有帮助。

    npx supabase@beta gen types typescript --local > lib/database.types.ts

  4. 配置环境变量: 复制仓库提供的 '.env.local' 示例内容，并根据你的本地环境进行配置。你需要设置 Supabase URL、匿名 Key、Redis URL 和 Replicate API Token (如果需要用到 Replicate 集成)。

    NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=YourSupabaseAnonKey
REDIS_URL=redis://localhost:6379
REPLICATE_API_TOKEN=YouReplicateApiToken

    注意: 请将 'YourSupabaseAnonKey' 和 'YouReplicateApiToken' 替换为你实际的值。

  5. 启动 Redis 服务器: 确保 Redis 服务器在本地运行。

    redis-server

  6. 安装依赖并运行开发服务器: 使用 'pnpm' 包管理器安装项目依赖，并启动 Next.js 开发服务器。

    pnpm i
pnpm run dev

    项目成功启动后，DadMCP 服务器将在本地 'http://localhost:3000' 运行。

服务器配置

为了让 MCP 客户端连接到 DadMCP 服务器，你需要提供服务器的启动配置信息。以下是根据仓库 'README.md' 提供的配置示例，你可以将其添加到 MCP 客户端的配置文件中。

{
  "mcpServers": {
    "DadMCP": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:3000/sse?token=YourAccessToken"
        // 将 http://localhost:3000 替换为 DadMCP 服务器的实际地址
        // YourAccessToken 需要替换为有效的访问令牌，如果服务器需要身份验证
      ]
    }
  }
}

配置参数说明:

  • '"DadMCP"': 服务器名称，可以自定义。
  • '"command": "npx"': 指定启动服务器的命令，这里使用 'npx' 运行 'mcp-remote'。
  • '"args"': 启动参数列表。
    • '"mcp-remote"': 推测是用于连接远程 MCP 服务器的客户端工具或脚本（仓库中未明确提供 'mcp-remote' 的具体信息，可能需要查阅相关文档或仓库）。
    • '"http://localhost:3000/sse?token=YourAccessToken"': MCP 服务器地址。
      • 'http://localhost:3000/sse': SSE (Server-Sent Events) 协议的端点，用于建立 MCP 客户端与 DadMCP 服务器的连接。
      • '?token=YourAccessToken': 可选的访问令牌参数，如果 DadMCP 服务器需要身份验证，则需要提供有效的访问令牌。你需要替换 'YourAccessToken' 为实际的令牌值。

请注意: 示例配置中的 'mcp-remote' 命令和 'YourAccessToken' 仅为示例，实际使用时可能需要根据 DadMCP 服务器的具体实现和安全策略进行调整。仓库中并没有找到 'mcp-remote' 的具体实现，可能需要用户自行根据 MCP 客户端的要求进行配置。 此外，服务器是否需要 'token' 验证也取决于 DadMCP 服务器的配置。

基本使用方法

  1. 启动 DadMCP 服务器: 按照安装步骤启动 DadMCP 服务器。
  2. 配置 MCP 客户端: 在你的 MCP 客户端应用中，添加上述提供的服务器配置信息。确保将服务器地址 '"http://localhost:3000/sse?token=YourAccessToken"' 替换为 DadMCP 服务器的实际地址和有效的访问令牌 (如果需要)。
  3. 连接服务器: 在 MCP 客户端中选择配置的 "DadMCP" 服务器，客户端将尝试与 DadMCP 服务器建立连接。
  4. 使用 AI 教育功能: 连接成功后，你就可以在 MCP 客户端中使用 DadMCP 服务器提供的教育资源和 AI 工具，例如访问学习资料、调用工具进行内容生成或推荐等。具体的功能取决于 DadMCP 服务器实现的资源和工具。

信息

分类

AI与计算

访问项目