DAMI Moodle Robot MCP Server v0.2.2

Zero-dependency MCP STDIO server for Xiaozhi/imcp. This version does not use @modelcontextprotocol/sdk, so it is lighter and easier for hosted MCP gateways to run from GitHub with npx.

imcp Manual STDIO configuration

Mode: STDIO

Command: npx

Arguments:

-y
--package
github:trantuandat0305/damirobot-mcp-server
damirobot-mcp-server

If the gateway still cannot load schemas, try the shorter argument form:

-y
github:trantuandat0305/damirobot-mcp-server

Environment variables:

VOICE=1
MOODLE_BASE_URL=https://elearning.anhngumsmy.com
DEFAULT_COURSEID=4
MOODLE_API_TOKEN=PUT_YOUR_TOKEN_HERE
REQUEST_TIMEOUT_MS=15000
MOODLE_TOOL_ENDPOINT=https://elearning.anhngumsmy.com/local/damirobot_api/api/tool.php

# Optional stricter whitelist.
# Leave empty to allow any non-empty speakerId produced by Xiaozhi voiceprint recognition.
# Example: ALLOWED_SPEAKER_IDS=id_1,id_2
ALLOWED_SPEAKER_IDS=

Related MCP server: moodle-mcp

Speaker authorization gate

All student-data tools are mandatory fail-closed before Moodle is called.

• Missing/null/invalid speakerId: denied.

• Sentinel values such as null, undefined, unknown, anonymous, guest, none: denied.

• speakerId must come from Xiaozhi top-level params.speakerId; _meta.speakerId is accepted as fallback.

• arguments.speakerId is deliberately ignored, so the LLM/tool arguments cannot grant access to themselves.

• When ALLOWED_SPEAKER_IDS is empty, any valid Xiaozhi-recognized speakerId is accepted. This supports adding a new registered speaker without firmware changes or MCP code changes.

• When ALLOWED_SPEAKER_IDS is configured, only exact IDs in that list are accepted.

• test_connection remains available without speaker recognition because it exposes no student data.

• There is no environment-variable bypass for the student-data guard.

Context isolation

The MCP server tracks the current recognized speaker so follow-up questions can work safely.

• Same authorized speakerId: student follow-up context may be reused.

• Different authorized speakerId: student/course/group follow-up context is cleared before the next data call.

• Missing/denied speaker: all speaker-bound context is cleared.

This prevents a later speaker from inheriting the previous speaker's selected student.

Tests

npm run check
npm test

The regression suite verifies fail-closed behavior, argument spoof rejection, malformed speaker IDs, optional explicit allowlists, speaker-switch context isolation, same-speaker follow-up context, and the non-sensitive test_connection exception.

GitHub Actions runs these checks on pushes and pull requests to main.

Tools

• test_connection

• find_student

• get_student_summary

• get_student_attendance

• get_missing_homework

• get_student_suspend_status

• get_student_dami_status

• get_student_latest_scores

• get_student_goal_status

• get_student_fulltest_history

• get_course_risk_students

Safety

• Student-data tools require an authorized Xiaozhi speaker identity.

• Read-only: only calls the Moodle DAMI Robot API.

• Does not write, update, delete, suspend, check-in, or feed DAMI.

• No token is stored in code. Put token only in environment variables.