学生数据集成工具

该项目通过Next.js和Thesys AI实现学生数据API的自然语言查询接口,提供实时数据集成和流式响应功能。

  • by SayamBipolar
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 sayambipolar/mcp-server

使用说明

Next.js学生数据与Thesys AI集成

该项目演示了学生数据API和Thesys AI之间的集成,提供了一个使用自然语言查询学生信息的智能界面。

特性

  • 使用MockAPI实时集成学生数据
  • 基于Thesys AI的自然语言处理
  • 流式响应,提供更好的用户体验
  • 使用CrayonAI的漂亮UI组件
  • TypeScript用于类型安全
  • 带有应用路由器的新式Next.js 15.2

先决条件

  • Node.js 18+
  • npm或纱线
  • Thesys API密钥

环境变量

创建一个 .env.local 根目录中的文件,其中包含:

THESYS_API_KEY=your_thesys_api_key_here

安装

  1. 克隆存储库:
git clone <repository-url>
cd template-c1-component-next
  1. 安装依赖项:
npm install
  1. 运行开发服务器:
npm run dev

该应用程序将在 http://localhost:3000

项目结构

template-c1-component-next/
├── src/
│   ├── app/
│   │   ├── api/
│   │   │   ├── ask/         # Thesys AI integration
│   │   │   └── mcp/         # Student data integration
│   │   ├── components/      # React components
│   │   ├── helpers/         # Utility functions
│   │   └── hooks/          # Custom React hooks
├── public/                  # Static assets
└── package.json            # Project dependencies

API集成

该项目集成了两个主要的API:

  1. 学生数据API

    • 端点: https://68651dad5b5d8d03397fc50c.mockapi.io/details
    • 提供学生信息,包括:
      • 名字
      • 电子邮件
      • 地址
      • 国家
      • 累计平均绩点
  2. Thesys人工智能API

    • 用于自然语言处理
    • 提供对查询的智能响应
    • 支持流式响应

使用示例

您可以使用自然语言查询学生数据。示例:

  1. 获取具体的学生详细信息:
What is Jeff Wolf's CGPA?
  1. 查找表现最佳的员工:
Show me all students with CGPA above 90
  1. 获取特定国家的数据:
List all students from Taiwan

组件

  1. MCP服务器(/api/mcp)

    • 处理数据集成
    • 用上下文丰富提示
    • 管理API通信
  2. 询问API(/api/ask)

    • 处理自然语言查询
    • 与Thesys AI集成
    • 处理流媒体响应
  3. UI组件

    • 使用CrayonAI组件
    • 响应式设计
    • 实时更新

发展

运行测试

npx tsx src/app/test.ts

生产大楼

npm run build

贡献

  1. 分叉存储库
  2. 创建功能分支
  3. 提交您的更改
  4. 推到分支
  5. 创建拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。