Adam MCP

亚当HTTP MCP

ADAM学校管理信息系统的HTTP MCP服务器。使用StreamableHTTPServerTransport通过HTTP将47个ADAM API端点显示为MCP工具。专为AI代理、Claude Desktop和任何MCP客户端而设计。

快速开始

npm install
npm run dev

服务器正在监听 http://localhost:3000/mcp.

配置

通过环境变量设置凭据：

export ADAM_API_TOKEN=your_30_character_token_here
export ADAM_BASE_URL=https://yourschool.adam.co.za/api
export PORT=3000  # optional, default 3000

从以下位置获取API令牌：管理>安全管理>管理API令牌。

可选：基于名称的查找

要按姓名搜索学生、家庭和教职员工，请设置数据查询机密（从“管理”>“数据查询”）：

export ADAM_DATAQUERY_PUPILS_SECRET=your_pupils_secret
export ADAM_DATAQUERY_FAMILIES_SECRET=your_families_secret
export ADAM_DATAQUERY_STAFF_SECRET=your_staff_secret

可选：SSL验证

export ADAM_VERIFY_SSL=false   # default: true

MCP客户端配置

克劳德桌面/克劳德代码

{
  "mcpServers": {
    "adam-school-mis": {
      "type": "streamable-http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

发展

# Development (no build, uses tsx)
npm run dev

# Build to dist/
npm run build

# Run production build
npm start

码头工人

docker build -t adam-http-mcp .
docker run -p 3000:3000 \
  -e ADAM_API_TOKEN=your_token \
  -e ADAM_BASE_URL=https://yourschool.adam.co.za/api \
  adam-http-mcp

工具

16个类别的47个MCP工具：

建筑

src/
  tools.ts    # Tool definitions (names, params, API path mappings)
  index.ts    # MCP server, Express HTTP transport, API client, custom handlers

• 简单的工具 直接映射到ADAM API路径： /api/{module}/{resource}/{param1}/{param2}/...
• 定制工具 处理复杂的逻辑（通过数据查询进行名称搜索、类父电子邮件编排、客户端过滤）
• 通过以下方式进行每次会话隔离 StreamableHTTPServerTransport
• ADAM响应包装器({"response": {"code": 200}, "data": ...})自动展开

许可证

本项目旨在与ADAM学校MIS装置一起使用。查看有关API使用的ADAM许可协议。