AI导哈

PDF资源搜索服务

Materio MCP Server是一个使AI助手能够直接搜索和读取Materio教育PDF资源的服务器，无需手动上传文件。

  • by Materioa
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Jinansh230705/mcp-server

使用说明

材料MCP服务器

一个MCP（模型上下文协议）服务器，支持AI助手，如 克劳德, ChatGPT，其他人可以直接搜索和阅读Materio的教育PDF资源，无需手动上传文件。

当用户询问时 @materio 关于一个主题，AI可以使用此服务器：

  • 📚 浏览 所有可用的学期、科目和资源
  • 🔍 搜索 用于特定主题、章节、题库等
  • 📄 阅读 完整的PDF内容，并使用材料自己的术语回答问题
  • 🔗 获取URL 分享或引用特定的PDF

运作原理

User → AI Assistant → MCP Server → Materio CDN → PDFs
                          ↓
                   Resource Library
                   (resource.lib.json)
  1. 服务器从以下位置获取Materio的资源库 cdn-materioa.vercel.app
  2. 它对所有学期、科目、类别和主题进行索引
  3. 当AI需要PDF时，它会从CDN中获取PDF并提取文本
  4. 人工智能使用提取的文本用适当的术语回答问题

可用工具

工具 目的
materio_list_resources 浏览所有可用资源（可按学期筛选）
materio_search 按关键字搜索所有资源
materio_get_pdf 获取并阅读PDF的全文内容
materio_get_pdf_url 获取PDF的CDN下载URL
materio_get_subject_overview 获取主题资源的完整概述

部署选项

选项1：部署到Vercel（远程-用于ChatGPT、远程Claude等）

快速部署

cd materio-mcp-server
npx vercel

或者链接到您的Vercel帐户并部署：

npx vercel --prod

部署什么

  • 端点： https://your-project.vercel.app/mcp （MCP为POST，健康检查为GET）
  • 困惑终点： https://your-project.vercel.app/mcp/pplx （JSON提取器友好的包装器）
  • 运输： 流式HTTP（无状态JSON-RPC）
  • 功能： api/mcp.js --60秒超时，1GB内存

使用已部署的服务器

部署后，使用远程URL配置您的AI客户端：

克劳德桌面（远程MCP）：

{
  "mcpServers": {
    "materio": {
      "url": "https://your-project.vercel.app/mcp"
    }
  }
}

ChatGPT（自定义GPT/操作）： 使用端点URL https://your-project.vercel.app/mcp 作为GPT配置中的MCP服务器URL。

健康检查：

curl https://your-project.vercel.app/mcp

选项2：本地运行（stdio--用于Claude Desktop）

安装

cd materio-mcp-server
npm install

配置Claude桌面

添加 %APPDATA%\Claude\claude_desktop_config.json （Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "materio": {
      "command": "node",
      "args": ["D:\\v4\\materio\\materio-mcp-server\\index.js"]
    }
  }
}

⚠️ 更新路径以匹配您的系统。

然后重新启动Claude Desktop。

使用示例

配置后，您可以向AI助手询问以下问题：

  • “第四学期有哪些科目？”
  • “查找操作系统死锁的注释”
  • “阅读数学2的拉普拉斯变换一章，解释考试的关键概念”
  • “给我DBMS题库”
  • “Java面向对象编程涵盖了哪些主题？”
  • “阅读继承一章，并创建一份涵盖所有考试相关要点的学习指南”

项目结构

materio-mcp-server/
├── server.js         # Shared core — all tools, utilities, server factory
├── index.js          # Local entry point (stdio transport)
├── api/
│   └── mcp.js        # Vercel entry point (HTTP transport)
├── vercel.json       # Vercel deployment config
├── package.json      # Dependencies and metadata
└── README.md         # This file

技术细节

  • 运行时间： Node.js≥18
  • 运输： stdio（本地）/流式HTTP（Vercel）
  • CDN： https://cdn-materioa.vercel.app
  • 资源库： 从CDN获取并缓存5分钟
  • PDF解析： 用途 pdf-parse 从PDF中提取文本
  • 字符限制： PDF文本输出上限为80000个字符
  • Vercel功能： 60秒超时，1GB内存（用于大型PDF解析）

许可证

麻省理工学院——©2024-2026，JTC材料。

相关 MCP