AI导哈

教育数据集成服务器

DatahubMCP是一个教育数据集成服务器，使LLM能够查询MySQL数据库和Google Workspace，用于教育项目管理。

  • by yucheuan
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 yucheuan/DatahubMCP

使用说明

DatahubMCP-教育数据集成服务器

MCP服务器使LLM能够查询MySQL数据库和Google Workspace进行教育项目管理。

它做什么

将LLM桌面应用程序连接到：

  • mysql数据库：企业数据库（出勤、课程计划、DRDP评估等）
  • Google 工作区：表格、表单、驱动器集成
  • 内置模板：数据分析和报告生成提示

技术栈

后端：Python 3.13、FastMCP、SQLAlchemy
应用程序编程接口：MySQL、谷歌OAuth 2.0、谷歌表格/表单/驱动器
配置：环境变量、凭证管理
建筑：服务层模式、连接池、上下文管理器

快速开始

# Install dependencies
uv sync

# Configure credentials
cp .env.example .env
# Edit .env with your DB and Google credentials

# Add to Claude Desktop config
{
  "mcpServers": {
    "datahub": {
      "command": "uv",
      "args": ["--directory", "/path/to/DatahubMCP", "run", "datahubmcp.py"]
    }
  }
}

主要特点

数据库工具

  • 查询考勤记录、课程计划、DRDP记录
  • 按日期范围、地点、教室、儿童ID筛选
  • 分层网站/教室列表

谷歌工作区工具

  • 列出/读取/写入电子表格，创建表单
  • 表数据作为MCP资源
  • OAuth身份验证流程

提示词

  • analyze_sheet_data：综合分析模板
  • create_report_template：专业报告
  • form_to_sheet：表单到电子表格工作流

项目结构

datahubmcp.py      # FastMCP server with tool definitions
database.py        # MySQL session management
google_service.py  # Google OAuth & API builders
models.py          # SQLAlchemy ORM models
.env.example       # Configuration template

示例用法

通过克劳德桌面应用程序自然语言：

"Show attendance for site S001 last week"
"Query DRDP records for child C456"
"List my recent spreadsheets"
"Create a feedback form"

技术亮点

  • 会话管理：安全DB/API访问的上下文管理器
  • 类型安全：整个代码库中的完整类型提示
  • 安全：基于环境的配置， .gitignore 获取凭据
  • 错误处理：全面的验证和用户友好的消息
  • 关注点分离：模块化架构（DB/API/MCP层）

专为：教育项目管理
联系：黄(@玉川)

相关 MCP