Datahub MCP

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层）

______________________________________________________________________

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