PLATO MCP Server
Unofficial MCP server for Pusan National University's PLATO Moodle-based LMS. Uses the Moodle webservice REST API plus authenticated HTML scraping to let AI assistants list courses and course contents, view assignments and submit them, check grades and completion status, read calendar events/upcoming deadlines, list quizzes and forum discussions, upload to private files, and download course files, plus read/post notices and Q&A on the PLATO ubboard.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PLATO MCP Server What are my assignments and deadlines this week?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
plato-mcp
๐ ์ค์น ๊ฐ์ด๋ ํ์ด์ง โ ํ๋ฒ/๋น๋ฐ๋ฒํธ๋ง ์ ๋ ฅํ๋ฉด Claude.ai, Claude Code, Codex CLI์ฉ ์ฐ๊ฒฐ ๋ช ๋ น์ด๋ฅผ ๋ฐ๋ก ๋ง๋ค์ด ๋๋ฆฝ๋๋ค.
๋ถ์ฐ๋ํ๊ต(PNU)์ ๋ฌด๋ค(Moodle) ๊ธฐ๋ฐ LMS์ธ PLATO(https://plato.pusan.ac.kr/)๋ฅผ ์ํ ๋น๊ณต์ MCP(Model Context Protocol) ์๋ฒ์ ๋๋ค. Claude ๊ฐ์ AI ์ด์์คํดํธ๊ฐ ์ฌ๋ฌ๋ถ์ ๋์ ํด PLATO์ ๋ก๊ทธ์ธํ์ง ์๊ณ ๋, ์ฌ๋ฌ๋ถ์ด ์ด๋ฏธ ์ ๊ทผ ๊ถํ์ ๊ฐ์ง ๊ฐ์ข ์๋ฃยท๊ณต์งยท๊ณผ์ ยท์ฑ์ ยทQ&A๋ฅผ ์กฐํยท์์ฑยท๋ค์ด๋ก๋ํ ์ ์๊ฒ ํด ์ค๋๋ค.
์์ง ๊ฐ๋ฐ ์ค์ ๋๋ค. ์ ์ฒด ๊ตฌํ ๊ณํ์
PLAN.md๋ฅผ, ํ์ฌ ์งํ ์ํฉ์ GitHub Issues / Project ๋ณด๋๋ฅผ ์ฐธ๊ณ ํ์ธ์.
์ด ์๋ฒ๋ ์๋ก์ด ๊ถํ์ ๋ถ์ฌํ์ง ์์ต๋๋ค. ์ฌ๋ฌ๋ถ์ PLATO ํ๋ฒยท๋น๋ฐ๋ฒํธ๋ก ์ธ์ฆํ๋ฉฐ, ๋ธ๋ผ์ฐ์ ๋ก ์ง์ ์ด๋ํ ๋ ๋ณผ ์ ์๋ ๊ฒ๋ง ๋ณผ ์ ์์ต๋๋ค โ ๋ค๋ง ๊ทธ ๋ด์ฉ์ด AI์์ ๋ํ๋ก ํ๋ฌ ๋ค์ด๊ฐ๋ค๋ ์ฐจ์ด๊ฐ ์์ต๋๋ค. ์์ํ๊ธฐ ์ ์ ์๋ ๋ฉด์ฑ ์กฐํญ๊ณผ ๊ฐ์ธ์ ๋ณด ์๋ด๋ฅผ ๋ฐ๋์ ์ฝ์ด ์ฃผ์ธ์.
์์ํ๊ธฐ
์ด ํ๋ก์ ํธ๋ ๋ ๋ถ๋ฅ์ ๋ ์๋ฅผ ๋์์ผ๋ก ํฉ๋๋ค โ ๊ทธ๋ฅ ์จ๋ณด๊ณ ์ถ์ ์ผ๋ฐ ์ฌ์ฉ์์ ์ฝ๋๋ฅผ ๊ณ ์น๊ฑฐ๋ ๊ธฐ์ฌํ๊ณ ์ถ์ ๊ฐ๋ฐ์. ์๋์์ ๋ณธ์ธ์๊ฒ ๋ง๋ ์ชฝ์ ๊ณ ๋ฅด์ธ์.
์ผ๋ฐ ์ฌ์ฉ์ โ ๊ทธ๋ฅ ์จ๋ณด๊ณ ์ถ๋ค๋ฉด
์ฝ๋๋ฅผ ๋ด๋ ค๋ฐ๊ฑฐ๋ ์๋ฒ๋ฅผ ์ง์ ์คํํ ํ์๊ฐ ์์ต๋๋ค. ์ด ์๋ฒ๋ ๊ณต์
MCP Registry์
io.github.jin-1119/plato-mcp๋ก ๋ฑ๋ก๋์ด ์๊ณ , ์ค์ ์ฃผ์๋
https://plato-mcp.onrender.com/mcp(Streamable HTTP)์
๋๋ค.
Smithery ๋ง์ผํ๋ ์ด์ค๋ ๋ ์ด์ ์ฐ์ง ์์ต๋๋ค โ Smithery๊ฐ ์ ๊ท ์ธ๋ถ ์๋ฒ ๋ฑ๋ก์ ๋ง๊ณ 2026-10-31์ ์ ์ฒด ์๋น์ค๋ฅผ ์ข ๋ฃํ๋ฉด์, ๊ณต์ ๋ ์ง์คํธ๋ฆฌ๋ก ์ฎ๊ฒผ์ต๋๋ค. ์์ธํ ๋ฐฐ๊ฒฝ์
docs/smithery_deployment_model.md๋ฅผ ์ฐธ๊ณ ํ์ธ์.
์ฌ์ฉ ์ค์ธ MCP ํด๋ผ์ด์ธํธ์์ ์๋ ์ฃผ์๋ฅผ ์๊ฒฉ(remote) MCP ์๋ฒ๋ก ์ถ๊ฐํฉ๋๋ค:
Claude.ai / Claude Desktop: ์ค์ โ Connectors โ Add custom connector โ URL์
https://plato-mcp.onrender.com/mcp์ ๋ ฅ.Claude Code:
claude mcp add --transport http plato-mcp https://plato-mcp.onrender.com/mcpMCP Registry๋ฅผ ์ง์ ๊ฒ์ํ ์ ์๋ ํด๋ผ์ด์ธํธ๋ผ๋ฉด
io.github.jin-1119/plato-mcp๋ก ์ฐพ์๋ ๋ฉ๋๋ค.
์ฐ๊ฒฐ ์ PLATO ํ๋ฒ๊ณผ ๋น๋ฐ๋ฒํธ๋ฅผ (ํด๋ผ์ด์ธํธ๊ฐ ์ง์ํ๋ ๊ฒฝ์ฐ) ์ปค๋ฅํฐ ์ค์ ๊ฐ์ผ๋ก, ์๋๋ฉด ํค๋/์ฟผ๋ฆฌ ํ๋ผ๋ฏธํฐ(
pnu_id,pnu_password)๋ก ์ ๋ ฅํฉ๋๋ค. ์ด ๊ฐ์ ์๋ฒ ๋์คํฌ์ ์ ์ฅ๋์ง ์์ผ๋ฉฐ, ์์ฒญ์ ์ฒ๋ฆฌํ๋ ๋์๋ง ๋ฉ๋ชจ๋ฆฌ์ ์กด์ฌํฉ๋๋ค โ ์์ธํ ๋ด์ฉ์SECURITY.md๋ฅผ ํ์ธํ์ธ์.์ฐ๊ฒฐ๋๋ฉด AI ์ด์์คํดํธ์๊ฒ ์์ฐ์ด๋ก ์์ฒญํ๋ฉด ๋ฉ๋๋ค. ์:
"์ด๋ฒ ์ฃผ์ ์ ์ถํด์ผ ํ ๊ณผ์ ๊ฐ ๋ญ๊ฐ ์์ด?"
"์ด๋ฒ ํ๊ธฐ ์ฑ์ ์๋ ค์ค"
"OO ๊ณผ๋ชฉ 3์ฃผ์ฐจ ๊ฐ์์๋ฃ ๋ค์ด๋ก๋ํด์ค"
"OO ๊ณผ๋ชฉ ๊ณต์ง์ฌํญ ์ต๊ทผ ๊ฒ๋ถํฐ ๋ณด์ฌ์ค"
์์ํ๊ธฐ ์ ์ ๋ฐ๋์ ์๋ ๋ฉด์ฑ ์กฐํญ๊ณผ ๊ฐ์ธ์ ๋ณด ์๋ด๋ฅผ ์ฝ์ด ์ฃผ์ธ์. ํนํ ๊ณผ์ ์ ์ถยทQ&A ๋ฑ๋ก์ฒ๋ผ ๋๋๋ฆด ์ ์๋ ๋์(โ๏ธ ํ์)์ ์คํ ์ ๋ฏธ๋ฆฌ๋ณด๊ธฐ ํ์ธ์ ๊ฑฐ์น๋๋ก ๋์ด ์์ต๋๋ค.
์ง์ ๋ฐฐํฌํด ๋ณด๊ณ ์ถ๋ค๋ฉด
docs/smithery_publish_guide.md์ ๋น์ ๊ณต์์ฉ ๋จ๊ณ๋ณ ๊ฐ์ด๋๋ฅผ ์ฐธ๊ณ ํ์ธ์.
๊ฐ๋ฐ์ โ ์ฝ๋๋ฅผ ๊ณ ์น๊ฑฐ๋ ๊ธฐ์ฌํ๊ณ ์ถ๋ค๋ฉด
๋ฒ๊ทธ ์์ , ์ ๋๊ตฌ ์ถ๊ฐ, ๋ฌธ์ ๊ฐ์ ๋ฑ ๊ธฐ์ฌ๋ฅผ ํ์ํฉ๋๋ค. ์ด์/๋ธ๋์น/PR์ ์ด
์ ์ฅ์๊ฐ ์ค์ ๋ก ์ด๋ป๊ฒ ์ด์ํ๋์ง๋ CONTRIBUTING.md์
์ ๋ฆฌ๋์ด ์์ต๋๋ค โ PR์ ๋ณด๋ด๊ธฐ ์ ์ ๋จผ์ ์ฝ์ด ์ฃผ์ธ์. ๋ก์ปฌ ๊ฐ๋ฐ ํ๊ฒฝ ์ค์ ์
๋ฐ๋ก ์๋ ๊ฐ๋ฐ ํ๊ฒฝ ์ค์ ์น์
์ ์ฐธ๊ณ ํ์ธ์.
Related MCP server: aswaya-mcp
์ ๊ณตํ๋ ๋๊ตฌ (MCP Tools)
๊ณต์ Moodle webservice API๋ก ๋์ํ๋ ๋๊ตฌ์, ubboard(๊ณต์ง/Q&A) HTML์ ๋ณธ์ธ ์ธ์
์ผ๋ก
์คํฌ๋ ์ดํํ๋ ๋๊ตฌ๋ก ๋๋ฉ๋๋ค. ์ฐ๊ธฐ ๋๊ตฌ(โ๏ธ)๋ ์คํ ์ ํ์ธ ์ ์ฐจ๋ฅผ ๊ฑฐ์นฉ๋๋ค
(์์ธํ ๋ด์ฉ์ docs/write_confirmation_pattern.md).
PLATO๊ฐ ์ค์ ๋ก ์ ๊ณตํ๋ 439๊ฐ Moodle API ํจ์ ์ ์ฒด๋ฅผ ์ด MCP๊ฐ ์ด๋ป๊ฒ ๋ค๋ค๋์ง(๊ตฌํ/์ค๋ณต/
๋นํ์ฑํ/๊ถํ์์/๋ฏธ๊ตฌํ ์ฌ์ )๋ docs/moodle_api_coverage.md
์ฐธ๊ณ .
๊ฐ์ข / ๊ณผ์ / ์ฑ์ / ์ผ์ / ์ชฝ์ง โ ๊ณต์ API
list_coursesโ ์๊ฐ ์ค์ธ ๊ฐ์ข ๋ชฉ๋กget_course_contentsโ ๊ฐ์ข ์ฝํ ์ธ (์ฃผ์ฐจ๋ณ ์๋ฃ ๋ฑ)get_course_updates_sinceโ ๊ฐ์ข ๋ณ๊ฒฝ์ฌํญ ๊ฐ์ง (ํ์ค Moodle ๋ชจ๋๋ง โ ubfile/ubboard/vod๋ ๋ณ๊ฒฝ๊ฐ์ง ์ฝ๋ฐฑ ๋ฏธ๊ตฌํ, ํฌํจ ์ ๋จ)get_course_moduleโ cmid๋ก ๋ชจ๋ ์ง์ ์กฐํsearch_coursesโ PLATO ์ ์ฒด ๊ฐ์ข ์นดํ๋ก๊ทธ ๊ฒ์ (์๊ฐ ์ค์ธ ๊ฐ์ข๋ง์ด ์๋)get_recent_coursesโ ์ต๊ทผ ์ ์ํ ๊ฐ์ข ๋ชฉ๋กget_recent_itemsโ ์ต๊ทผ ์ด์ด๋ณธ ๊ฐ์์๋ฃ/ํ๋ ๋ชฉ๋ก (๊ฐ์ข ๋จ์๊ฐ ์๋ ๋ชจ๋ ๋จ์)get_starred_coursesโ ์ฆ๊ฒจ์ฐพ๊ธฐํ ๊ฐ์ข ๋ชฉ๋กlist_video_conferencesโ ํ์๊ฐ์(BigBlueButton) ์กฐํ (์ฐธ์ฌ ๊ธฐ๋ฅ์ ๋ฏธ์ง์, ์ค์ฌ์ฉ ์ฌ๋ก ์๋ forward-looking ๊ธฐ๋ฅ)list_lessonsโ Lesson ํ๋ ์กฐํ (์์ ๊ธฐ๋ฅ์ ๋ฏธ์ง์, ์ค์ฌ์ฉ ์ฌ๋ก ์์)list_workshopsโ Workshop(์ํธํ๊ฐ) ํ๋ ์กฐํ (์ ์ถ/ํ๊ฐ ๊ธฐ๋ฅ์ ๋ฏธ์ง์, ์ค์ฌ์ฉ ์ฌ๋ก ์์)list_feedbacksโ Feedback(์ค๋ฌธ) ํ๋ ์กฐํ (์๋ต ๊ธฐ๋ฅ์ ๋ฏธ์ง์, ์ค์ฌ์ฉ ์ฌ๋ก ์์)list_choices/list_surveysโ Choice(ํฌํ)/Survey ํ๋ ์กฐํ (์๋ต ๊ธฐ๋ฅ์ ๋ฏธ์ง์, ์ค์ฌ์ฉ ์ฌ๋ก ์์)list_scorms/list_h5p_activitiesโ SCORM/H5P ํจํค์ง ์ฝํ ์ธ ์กฐํ (์คํ/์ถ์ ๊ธฐ๋ฅ์ ๋ฏธ์ง์, ์ค์ฌ์ฉ ์ฌ๋ก ์์)list_glossariesโ Glossary(์ฉ์ด์ง) ์กฐํ (ํญ๋ชฉ ์ฝ๊ธฐ/์ฐ๊ธฐ๋ ๋ฏธ์ง์, ์ค์ฌ์ฉ ์ฌ๋ก ์์)list_database_activitiesโ Database ํ๋ ์กฐํ (ํญ๋ชฉ ์ฝ๊ธฐ/์ฐ๊ธฐ๋ ๋ฏธ์ง์, ์ค์ฌ์ฉ ์ฌ๋ก ์์)list_wikis/list_chatsโ Wiki/์ค์๊ฐ ์ฑํ ํ๋ ์กฐํ (์ฝ๊ธฐ/์ฐ๊ธฐ๋ ๋ฏธ์ง์, ์ค์ฌ์ฉ ์ฌ๋ก ์์)get_user_profileโ ์ฌ์ฉ์ ํ๋กํ ์กฐํ (๊ฐ์ ๊ฐ์ข ์๊ฐ์๋ง, ์ ์ฒด ๊ฒ์ ์๋)get_private_files_info/add_private_fileโ๏ธ โ ๊ฐ์ธํ์ผ ์์ญ ์กฐํ/์ ๋ก๋ (โ ๏ธ ์ญ์ ๋๊ตฌ ์์, ์ค์ ์ญ์ ๋ PLATO ์น์์)get_user_preferencesโ ์ฌ์ฉ์ ํ๊ฒฝ์ค์ ์กฐํ (๋๋ถ๋ถ ๋ด๋ถ UI ์ํ๊ฐ)get_my_course_groupsโ ๊ฐ์ข ๋ด ์์ ๊ทธ๋ฃน ์กฐํget_enrolled_usersโ ๊ฐ์ข ์๊ฐ์ ๋ช ๋จ ์กฐํ (PLATO ์ฐธ๊ฐ์ ๋ชฉ๋ก๊ณผ ๋์ผ ์ ๋ณด)list_assignmentsโ ๊ณผ์ ๋ชฉ๋กget_assignment_detailโ ๊ณผ์ ์์ธsubmit_assignmentโ๏ธ โ ๊ณผ์ ์ ์ถremove_submissionโ๏ธ โ ๊ณผ์ ์ ์ถ ์ฒ ํ (โ ๏ธ ์ค์ ์คํ ๊ฒฝ๋ก๋ ์์ง PLATO์์invalidparameter์ค๋ฅ ๋ฐ์, ๋ฏธ๋ฆฌ๋ณด๊ธฐ๋ง ๋์ ํ์ธ๋จ)get_gradesโ ์ฑ์ ์กฐํget_grades_access_infoโ ์ด ๊ณ์ ์ ์ฑ์ ์กฐํ ๊ถํ ํ์ธ (์ ์ฒด ์ด๋ ๊ถํ ๋ฑ)list_calendar_eventsโ ์บ๋ฆฐ๋ ์ผ์ get_calendar_access_infoโ ์บ๋ฆฐ๋ ๊ด๋ฆฌ ๊ถํ ํ์ธcreate_calendar_event/delete_calendar_eventโ๏ธ โ ๊ฐ์ธ ์บ๋ฆฐ๋ ์ผ์ ์์ฑ/์ญ์ (๋ณธ์ธ ์์ ๊ฐ์ธ ์ผ์ ๋ง ๊ฐ๋ฅ, ๊ฐ์ข/๊ทธ๋ฃน ์ผ์ ์ ๋ถ๊ฐ)get_unread_messages/get_unread_notification_countโ ์ ์ฝ์ ์ชฝ์ง (โ ๏ธ PLATO๋ 1:1 ๋ฉ์์ง/๋ํ ๊ธฐ๋ฅ์ด ์ฌ์ดํธ ์ ์ฒด์์ ๋นํ์ฑํ๋์ด ์์ โ ์๋ฆผ๋ง ๋์)get_course_completion_statusโ ๊ฐ์ข ๋จ์ ์ด์ ํํฉ (์ด์ ๊ธฐ์ค์ด ์ค์ ๋ ๊ฐ์ข๋ง)get_activity_completion_statusโ ๊ฐ์ข ๋ด ํ๋/์๋ฃ๋ณ ์ด์ ํํฉ (๋์์ ๊ฐ์ ์์ฒญ๋ฅ ํฌํจ)get_upcoming_action_eventsโ ๋ง๊ฐ ์๋ฐํ ํ ์ผ(๊ณผ์ /์์ฒญ ๊ธฐํ ๋ฑ) ํตํฉ ์กฐํget_courses_by_timelineโ ์งํ ์ค/์์ /์ข ๋ฃ ๊ฐ์ข ํํฐ๋งget_grades_overviewโ ์ ์ฒด ๊ฐ์ข ์ข ํฉ ์ฑ์ ํ ๋ฒ์ ์กฐํlist_quizzes/get_quiz_attempts/get_quiz_best_gradeโ ํด์ฆ ์กฐํget_quiz_access_information/get_quiz_required_qtypes/get_quiz_feedback_for_grade/get_quiz_combined_review_optionsโ ํด์ฆ ์์ ์ ํ์ธ์ฉ ์กฐํ (โ ๏ธ ์๋ต ํํ ๋ฏธ๊ฒ์ฆ โ ์ค์ ํด์ฆ๊ฐ ์๋ ๊ฐ์ข๊ฐ ์์ด์ ํ๋ผ๋ฏธํฐ๋ง ๋ผ์ด๋ธ๋ก ํ์ธ๋จ)start_quiz_attempt/get_quiz_attempt_data/save_quiz_attempt_responses/process_quiz_attempt/get_quiz_attempt_summary/get_quiz_attempt_reviewโ๏ธ โ ํด์ฆ ์์ ํ๋ฆ (โ ๏ธ ์ ์ฒด ๋ฏธ๊ฒ์ฆ, ์ค์ ํด์ฆ๋ก ๋๊น์ง ํ ์คํธ๋ ์ ์์ โ ์ฌ์ฉ ์ ๋ฐ๋์ ์ฌ๊ฒ์ฆ ๊ถ์ฅ)list_forums/get_forum_discussions/get_discussion_postsโ ํ์ค Moodle ํฌ๋ผ ์กฐํ (PLATO ์์ฒด ๊ณต์ง/Q&A์ธubboard์๋ ๋ค๋ฅธ ๋ชจ๋)add_discussion/add_discussion_postโ๏ธ โ ํฌ๋ผ ๊ธ์ฐ๊ธฐ/๋ต๊ธ
๊ณต์ง์ฌํญ / Q&A(ubboard) โ ๋ก๊ทธ์ธ ์ธ์
์คํฌ๋ ์ดํ
list_noticesโ ๊ณต์ง์ฌํญ ๋ชฉ๋กget_notice_detailโ ๊ณต์ง์ฌํญ ์์ธlist_qnaโ Q&A ๊ฒ์๊ธ ๋ชฉ๋กget_qna_detailโ Q&A ๊ฒ์๊ธ ์์ธpost_qna_questionโ๏ธ โ Q&A ์ง๋ฌธ ๋ฑ๋ก
ํ์ผ
download_course_fileโ ๊ฐ์ข ์ฒจ๋ถํ์ผ ๋ค์ด๋ก๋ (์๊ฒฉ ์คํ ์ ๋งํฌ ๋ฐํ, ์ ๊ฐ์ธ์ ๋ณด ์๋ด ์ฐธ๊ณ )
์ํคํ ์ฒ
src/plato_mcp/
โโโ server.py # FastMCP ์ฑ, tool ๋ฑ๋ก ์ง์
์
โโโ config.py # Smithery config ์คํค๋ง (pnu_id, pnu_password, ...)
โโโ auth.py # ์ธ์
๋ณ wstoken + requests.Session ์ฟ ํค in-memory ์บ์
โโโ moodle_client.py # webservice/rest/server.php ๋ฒ์ฉ REST ํธ์ถ ๋ํผ
โโโ ubboard/
โ โโโ scraper.py # list_notices/get_notice_detail/list_qna/get_qna_detail
โ โโโ writer.py # post_qna_question (sesskey ์ฒ๋ฆฌ)
โ โโโ parser.py # BeautifulSoup ํ์ฑ
โโโ files.py # download_course_file
โโโ tools/ # MCP tool ๋ฑ๋ก (courses/assignments/grades/calendar/messages/notices_qna/downloads)
โโโ models.py # pydantic ์๋ต ์คํค๋ง
โโโ errors.py # ํ์
์์ธ (AuthError, MoodleAPIError, ScrapeError, RateLimitError)
โโโ security.py # ๋ก๊ทธ/์๊ฒฉ์ฆ๋ช
๋ง์คํน, rate limiting์ธ์ฆ ํ๋ฆ: ์ธ์
์์ ์ login/token.php๋ก wstoken์ ๋ฐ๊ธ๋ฐ์ ๋ฉ๋ชจ๋ฆฌ์ ์บ์ํฉ๋๋ค.
ubboard(๊ณต์ง/Q&A) ์ ๊ทผ ์์๋ง ์ถ๊ฐ๋ก ์ฟ ํค ๋ก๊ทธ์ธ์ ์ํํด sesskey๋ฅผ ์คํฌ๋ ์ดํํฉ๋๋ค.
์ด๋ค ๊ฒฝ์ฐ๋ ๋์คํฌ์ ์ ์ฅํ์ง ์์ต๋๋ค. ๋ฐฐ๊ฒฝ์ด ๋ ์ฌ์ ์กฐ์ฌ๋
PLATO_MCP_์ฌ์ ์กฐ์ฌ.md, ์ ์ฒด ๋ก๋๋งต์
PLAN.md๋ฅผ ์ฐธ๊ณ ํ์ธ์.
๊ฐ๋ฐ ํ๊ฒฝ ์ค์ (๊ธฐ์ฌ์์ฉ)
์๋๋ ์ด ํ๋ก์ ํธ์ ์ฝ๋๋ฅผ ์์ /๊ธฐ์ฌํ๋ ค๋ ๊ฐ๋ฐ์์ฉ ๋ช ๋ น์ด์ ๋๋ค. PLATO๋ฅผ ๊ทธ๋ฅ ์จ๋ณด๊ณ ์ถ์ ์ผ๋ฐ ์ฌ์ฉ์๋ ๋ชฐ๋ผ๋ ๋๋ ๋ด์ฉ์ด๋ฉฐ, ์คํํด๋ PLATO ๊ณ์ ์ ์ฐ๊ฒฐ๋์ง ์์ต๋๋ค โ ์ฝ๋์ ํ ์คํธ ๋๊ตฌ(
pytest,ruff๋ฑ)๋ฅผ ๋ด ์ปดํจํฐ์ ์ค์นํ ๋ฟ์ ๋๋ค.
์ฌ์ ์๊ฑด
Python 3.11+
๋ก์ปฌ ๊ฐ๋ฐ/ํ ์คํธ์๋ ์ค์ PLATO ๊ณ์ ์ด ํ์ ์์ต๋๋ค (ํ ์คํธ๋ mock ๊ธฐ๋ฐ)
pip install -e ".[dev]"
pytest๋ฉด์ฑ ์กฐํญ
๋ถ์ฐ๋ํ๊ต(PNU) ๋๋ PLATO/๋ฌด๋ค ํ๋ซํผ๊ณผ ์๋ฌด๋ฐ ์ ํด ๊ด๊ณ๊ฐ ์์ผ๋ฉฐ, ์ด๋ค์ ์น์ธ์ ๋ฐ์ง ์์์ต๋๋ค. ์ด ํ๋ก์ ํธ๋ ์ฌ๋ฌ๋ถ์ด ์ด๋ฏธ ๋ธ๋ผ์ฐ์ ๋ก ํ๊ณ ์๋ ๊ฒ๊ณผ ๋์ผํ PLATO ๊ณ์ ์ ๊ทผ์ ์๋ํํ๋ ๋ ๋ฆฝ์ ์ธ ์ปค๋ฎค๋ํฐ ํ๋ก์ ํธ์ ๋๋ค โ ์๋ก์ด ๊ถํ์ ๋ถ์ฌํ์ง ์์ผ๋ฉฐ PNU๋ฅผ ๋์ ํด ์ด๋ ํ ํ์๋ ํ์ง ์์ต๋๋ค.
๋ชจ๋ ์ฌ์ฉ์ ๋ณธ์ธ ์ฑ ์์ด๋ฉฐ, PNU์ ์ด์ฉ์ฝ๊ด์ ์ค์ํด์ผ ํฉ๋๋ค. ํนํ ๊ณต์ง์ฌํญ/Q&A ๊ฒ์ํ(
ubboard)์ ๊ณต์ API๊ฐ ์์ด ๋ก๊ทธ์ธ๋ ๋ณธ์ธ ์ธ์ ์ผ๋ก ๋ ๋๋ง๋ HTML์ ์ง์ ์คํฌ๋ ์ดํํ๋๋ฐ, ์ด ์ฌ์ดํธ์robots.txt๋Disallow: /๋ฅผ ๋ช ์ํ๊ณ ์์ต๋๋ค. ์ด ์ง์นจ์ ์ต๋ช ํฌ๋กค๋ฌ๋ฅผ ๊ฒจ๋ฅํ ๊ฒ์ด๋ฉฐ ์ธ์ฆ๋ ์ฌ์ฉ์ ๋ณธ์ธ์ ์ด๋ ํ์๋ฅผ ๊ฒจ๋ฅํ ๊ฒ์ ์๋์ง๋ง, ๊ทธ๋๋ ์คํฌ๋ ์ดํ์ธ ๊ฒ์ ์ฌ์ค์ ๋๋ค. ์ด ์๋ฒ๋ฅผ ๊ณ์ ์ ์ฐ๊ฒฐํ๊ธฐ ์ ์ ๋ณธ์ธ ๊ณ์ ์ ๋ํ PNU์ acceptable-use ์ ์ฑ ์ ๋ถํฉํ๋์ง ํ์ธํ ์ฑ ์์ ์ฌ์ฉ์์๊ฒ ์์ต๋๋ค. ๊ถ์ฅ ์ฌ์ฉ ๋ฐฉ์์ ๊ฐ์ธ์ ยท์ ๋น๋ ์ฌ์ฉ์ด๋ฉฐ, ์ฌ์ดํธ ์ ์ฒด๋ฅผ ๋์์ผ๋ก ํ ์๋ ๋๋ ์คํฌ๋ ์ดํ์ ๊ถ์ฅํ์ง ์์ต๋๋ค.PLATO ๋ก๊ทธ์ธ ์ ๋ณด๋ ์ด ์๋ฒ์ ์ํด ๋์คํฌ์ ์๊ตฌ ์ ์ฅ๋์ง ์์ต๋๋ค. ๋ฌด์์ด, ์ผ๋ง๋ ์ค๋ ์ ์ฅ/๋ณด๊ด๋๋์ง ์ ํํ ๋ด์ฉ์
SECURITY.md๋ฅผ ์ฐธ๊ณ ํ์ธ์.์ด ํ๋ก์ ํธ๋ ์ 3์์ ์ํ ๋ ๋ฆฝ์ ์ธ ๋ณด์ ๊ฐ์ฌ๋ฅผ ๋ฐ์ง ์์์ต๋๋ค. ๊ฐ๋ฐ ๊ณผ์ ์์ ์์ฒด์ ์ผ๋ก ์ฌ๋ฌ ์๊ฒฉ์ฆ๋ช ์ฒ๋ฆฌยท์ค๋จ์ฉ ๋ฐฉ์ง ์ด์๋ฅผ ๋ฐ๊ฒฌํ๊ณ ์์ ํ์ต๋๋ค (
docs/security_audit.md,docs/abuse_prevention_review.md์ฐธ๊ณ ) โ ํ์ง๋ง ์ค์ค๋ก ์ฐพ์ ๊ณ ์น ๊ฒ์ ์ธ๋ถ ๊ฐ์ฌ์ ๊ฐ์ ์์ค์ ๋ณด์ฆ์ด ์๋๋๋ค.
๊ฐ์ธ์ ๋ณด ์๋ด
์ด ์๋ฒ๋ ๊ฐ์ข ์ฝํ ์ธ ๋ฅผ ๊ทธ๋๋ก ์ ๋ฌํฉ๋๋ค โ Q&A ๊ฒ์ํ์ ๊ฒฝ์ฐ ๋ค๋ฅธ ํ์๋ค์ ์ด๋ฆ๊ณผ ๊ฒ์๊ธ๋ ํฌํจ๋ฉ๋๋ค. ์ด๋ ๋ณธ์ธ ๊ณ์ ์ด PLATO๋ฅผ ํตํด ์ด๋ฏธ ์ ๋นํ๊ฒ ์ ๊ทผํ ์ ์๋ ๋ด์ฉ์ด๋ฉฐ, ์ด ๋๊ตฌ๊ฐ ์๋ก์ด ์ ๊ทผ ๊ถํ์ ๋ถ์ฌํ๋ ๊ฒ์ ์๋๋๋ค. ๋ธ๋ผ์ฐ์ ๋ก PLATO๋ฅผ ์ง์ ์ด๋ํ ๋์ ๋ค๋ฅธ ์ ์, ์ด ๋ด์ฉ์ด AI ์ด์์คํดํธ์ ๋๋๋ ๋ํ์ ์ผ๋ถ๊ฐ ๋๋ค๋ ๊ฒ์ ๋๋ค. ์ฆ ๋๊ตฌ ์ถ๋ ฅ์ผ๋ก์ ํด๋น AI/LLM ์ ๊ณต์ ์ฒด(์: Anthropic)์ ์ ์ก๋ฉ๋๋ค. ๊ฐ์ข Q&A ๊ฒ์ํ์ ๋์์ผ๋ก ํญ๋์ ์ง๋ฌธ์ ํ๊ธฐ ์ ์ ์ด ์ ์ ์ ๋ ํ์ธ์.
์ ์ฒด ๊ฒํ ๋ด์ฉ๊ณผ ์๋ ค์ง ๋ฏธํด๊ฒฐ ์ฌํญ(PLATO๊ฐ Q&A ๊ฒ์๊ธ์ "๋น๊ณต๊ฐ/๊ฐ์ฌ ์ ์ฉ" ํ๋๊ทธ๋ฅผ
์๋ฒ ์ธก์์ ์ค์ ๋ก ๊ฐ์ ํ๋์ง โ ์ฆ ์ด ๋๊ตฌ๊ฐ ๊ทธ๋ฐ ๊ฒ์๊ธ์ ์ ์ด์ ๋ณผ ์ ์๋์ง โ
์ฌ๋ถ๋ ์์ง ์ค์ฆ์ ์ผ๋ก ๊ฒ์ฆ๋์ง ์์์ต๋๋ค)์
docs/pii_review.md์์ ํ์ธํ ์ ์์ต๋๋ค.
์๊ฒฉ์ผ๋ก ์คํํ ๊ฒฝ์ฐ (๋ก์ปฌ Claude Code/Desktop์ด ์๋๋ผ Claude.ai ์ปค๋ฅํฐ ๋ฑ์
ํตํด ์คํํ๋ ๊ฒฝ์ฐ), ์ธ๋ผ์ธ ์ ์ก ํฌ๊ธฐ ์ ํ์ ์ด๊ณผํ๋ ํฐ ํ์ผ์ ๋ํด
download_course_file์ ํ์ผ ์์ฒด๊ฐ ์๋๋ผ ๋ค์ด๋ก๋ ๋งํฌ๋ฅผ ๋ฐํํ๋ฉฐ, ์ด ๋งํฌ์๋
์ด์์๋ PLATO ์ก์ธ์ค ํ ํฐ์ด ํฌํจ๋์ด ์์ต๋๋ค. ์ด ํ ํฐ์ ํด๋น ํ์ผ ํ๋์๋ง
ํ์ ๋์ง ์์ต๋๋ค โ ์ค์ ๋ก ํ์ธํด ๋ณธ ๊ฒฐ๊ณผ ๋ณธ์ธ ๊ณ์ ์ ๋ํ ์์์ PLATO API ํธ์ถ์
์ธ์ฆํ๋ ๋ฐ ์ฌ์ฉํ ์ ์์์ต๋๋ค. ์ด ๋งํฌ๋ ์ด ๋งํฌ๊ฐ ํฌํจ๋ ๋ํ ๊ธฐ๋ก์ ๊ณต์ ํ๋
๊ฒ์ ํ์ผ ํ๋๋ฅผ ๊ณต์ ํ๋ ๊ฒ์ด ์๋๋ผ ๊ณ์ ์ ๋ํ ํ์ฑ ์๊ฒฉ์ฆ๋ช
์ ๊ณต์ ํ๋ ๊ฒ๊ณผ
๊ฐ์ต๋๋ค. ์์ธํ ๋ด์ฉ์ SECURITY.md์
docs/smithery_deployment_model.md๋ฅผ
์ฐธ๊ณ ํ์ธ์.
Lint:
ruff check .์ด์/๋ณด๋ ์ด์ ๋ฐฉ์์
PLAN.md๋ฅผ ์ฐธ๊ณ ํ์ธ์.๊ธฐ์ฌ ๋ฐฉ๋ฒ์
CONTRIBUTING.md๋ฅผ ์ฐธ๊ณ ํ์ธ์.
๋ผ์ด์ ์ค
AGPL-3.0์ ๋๋ค. ์ด ์๋ฒ(๋๋ ์์ ๋ณธ)๋ฅผ ๋คํธ์ํฌ ์๋น์ค๋ก ๋๋ ค ๋ค๋ฅธ ์ฌ๋์๊ฒ ์ ๊ณตํ๋ ๊ฒฝ์ฐ, AGPL์ ๋ฐ๋ผ ํด๋น ์์ค์ฝ๋๋ ํจ๊ป ๊ณต๊ฐํด์ผ ํฉ๋๋ค.
Available Tools
67 toolsadd_discussionADestructiveInspect
Start a new discussion thread in a forum. IRREVERSIBLE once dry_run=False.
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm.
Inputs: message (required), subject (required), forum_id (required), dry_run. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
add_discussion_postADestructiveInspect
Reply to a forum discussion thread. IRREVERSIBLE once dry_run=False.
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm.
Inputs: message (required), discussion_id (required), dry_run, subject. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
add_private_fileADestructiveInspect
Upload a file to this account's Moodle private files area. IRREVERSIBLE once dry_run=False -- no delete tool exists for private files yet, so this permanently adds the file until the user removes it via PLATO's own UI. Only works when this server is running locally (stdio).
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm.
Inputs: file_path (required), dry_run. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
create_calendar_eventADestructiveInspect
Create a personal calendar entry. IRREVERSIBLE once dry_run=False. Only personal ("user") events are supported -- course/group events are not something a student account can create.
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm.
Inputs: name (required), timestart (required), dry_run, description, +1 more. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
delete_calendar_eventADestructiveInspect
Delete a personal calendar entry this account owns. IRREVERSIBLE once dry_run=False.
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm.
Inputs: event_id (required), dry_run. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
download_course_fileARead-onlyInspect
Download a course file (the fileurl from get_course_contents).
Running locally (stdio, e.g. Claude Code/Desktop): saves the file to
save_path on this machine and returns the saved path -- save_path
is required in this case.
Running as a remote/hosted server (streamable-http, e.g. reached via
a Claude.ai web/mobile Connector): this server's own disk is not
reachable by you, so do NOT pass save_path -- it will be rejected.
Instead the file is fetched here and returned inline as base64
content for you to decode and present, unless it's too large, in
which case a direct authenticated download URL is returned instead
(that URL embeds a live PLATO access token: do not share it or a
chat transcript containing it).
Only common course-material extensions are allowed (pdf, office docs, images, zip, txt); local downloads over the configured size limit are rejected.
Inputs: file_url (required), save_path. Returns: result
get_activity_completion_statusARead-onlyInspect
Get this account's completion status for every activity/module in
a course -- richer than get_course_contents's per-module completed
flag (includes tracking rules, e.g. 'must view' vs 'must spend N
minutes'). For vod (video lecture) modules specifically, prefer
get_course_contents, whose per-module vod_progress field also
includes watch-percentage and deadline info this function doesn't
return.
Inputs: course_id (required). Returns: result
get_assignment_detailBRead-onlyInspect
Get one assignment's details and this account's submission status.
Inputs: course_id (required), assignment_id (required). Returns: extra, feedback, assignment, submission, +1 more
get_calendar_access_infoARead-onlyInspect
Check this account's calendar-management permissions -- a student account can typically manage its own personal entries only, not course/group entries.
Inputs: no named parameters. Returns: Result of core_calendar_get_calendar_access_information (issue #90) -- confirmeโฆ
get_course_completion_statusARead-onlyInspect
Get this account's overall course-completion status, if the course
has course-level completion criteria configured. Most courses on
this platform don't (available=False, with a message explaining
why) -- try get_activity_completion_status for per-activity
progress instead, or get_course_contents's per-module completed
flag.
Inputs: course_id (required). Returns: Result of `core_completion_get_course_completion_status` (issue #88). `availablโฆ
get_course_contentsARead-onlyInspect
Get a course's weekly sections, modules, and file links.
Inputs: course_id (required). Returns: result
get_course_moduleARead-onlyInspect
Resolve a single course module by its id directly, without fetching and filtering the whole course's contents.
Inputs: cmid (required). Returns: Result of core_course_get_course_module / get_course_module_by_instance (issueโฆ
get_courses_by_timelineARead-onlyInspect
List enrolled courses filtered by Moodle's own timeline classification (in-progress/future/past), based on course start/end dates. Unlike list_courses (which returns everything unfiltered), this answers "what am I actually taking right now" directly.
Inputs: classification. Returns: result
get_course_updates_sinceARead-onlyInspect
Get what changed in a course since a given time -- configuration,
completion, grades, submissions, etc. Only reports modules that
implement Moodle's change-tracking (confirmed: the standard assign
module does; this platform's own custom lecture-file/board/video
modules do not, so this won't catch a new ubfile lecture or ubboard
post -- use get_course_contents/list_notices to check those instead.
Inputs: since (required), course_id (required). Returns: result
get_discussion_postsBRead-onlyInspect
Get all posts in one forum discussion thread.
Inputs: discussion_id (required). Returns: result
get_enrolled_usersBRead-onlyInspect
Get the list of users enrolled in a course (classmates and instructors), with their role. Same data visible in PLATO's own participant list to any enrolled student.
Inputs: course_id (required). Returns: result
get_forum_discussionsBRead-onlyInspect
List discussion threads in one standard Moodle forum.
Inputs: forum_id (required). Returns: result
get_gradesCRead-onlyInspect
Get this account's grade items for a course, if visible.
Inputs: course_id (required). Returns: message, courseid, available, gradeitems
get_grades_access_infoARead-onlyInspect
Check what grade-related permissions this account has in a course -- e.g. whether it can see its own grades vs. (as a teacher/TA) everyone's grades. Most student accounts will see canviewallgrades=False.
Inputs: course_id (required). Returns: Result of gradereport_user_get_access_information (issue #95) -- confirmed liveโฆ
get_grades_overviewARead-onlyInspect
Get this account's overall grade for every enrolled course in one call. For the individual grade items within one course (e.g. each assignment's score), use get_grades instead -- this tool only returns one summary grade per course.
Inputs: no named parameters. Returns: result
get_my_course_groupsARead-onlyInspect
Get the groups this account belongs to within a course, if any.
Inputs: course_id (required). Returns: result
get_notice_detailARead-onlyInspect
Get the full text of one notice/announcement.
Inputs: post_id (required), course_id (required). Returns: A single post's detail page.
get_private_files_infoARead-onlyInspect
Get a summary (file/folder count, total size) of this account's Moodle private files area.
Inputs: no named parameters. Returns: Result of core_user_get_private_files_info (issue #96) -- confirmed live againsโฆ
get_qna_detailBRead-onlyInspect
Get one Q&A question's text. Does not include replies -- see issue #23.
Inputs: post_id (required), course_id (required). Returns: A single post's detail page.
get_quiz_access_informationARead-onlyInspect
Check whether this account can currently attempt a quiz, and why not if blocked (e.g. time window, password, previous attempts exhausted). UNVERIFIED against a real quiz -- call this before start_quiz_attempt and sanity-check the result.
Inputs: quiz_id (required). Returns: Result of mod_quiz_get_quiz_access_information -- schema-only, reconstructed frโฆ
get_quiz_attempt_dataARead-onlyInspect
Get the questions for one page of an in-progress quiz attempt.
Each question's html is Moodle's own rendered question form --
parse it for the actual answer-field names before calling
save_quiz_attempt_responses/process_quiz_attempt. UNVERIFIED
against a real quiz.
Inputs: attempt_id (required), page. Returns: Result of mod_quiz_get_attempt_data -- schema-only, UNVERIFIED.
get_quiz_attempt_reviewARead-onlyInspect
Get the grade and per-question review for a finished quiz attempt. UNVERIFIED against a real quiz.
Inputs: attempt_id (required), page. Returns: Result of mod_quiz_get_attempt_review -- schema-only, UNVERIFIED.
get_quiz_attemptsCRead-onlyInspect
Get this account's past attempts at one quiz.
Inputs: quiz_id (required). Returns: result
get_quiz_attempt_summaryARead-onlyInspect
Get a summary of all questions in an attempt (answered/ unanswered), across all pages. UNVERIFIED against a real quiz.
Inputs: attempt_id (required). Returns: Result of mod_quiz_get_attempt_summary -- schema-only, UNVERIFIED.
get_quiz_best_gradeARead-onlyInspect
Get this account's best grade on one quiz, if any attempt has been graded.
Inputs: quiz_id (required). Returns: Result of mod_quiz_get_user_best_grade -- schema-only, see QuizSummary's docstrโฆ
get_quiz_combined_review_optionsARead-onlyInspect
Check which review details (marks, feedback, right answers) this account is allowed to see for a quiz's attempts.
Inputs: quiz_id (required), attempt_id. Returns: Flattened view of mod_quiz_get_combined_review_options's `someoptions`/`alloptiโฆ
get_quiz_feedback_for_gradeARead-onlyInspect
Get the grade-boundary feedback text configured for a quiz at a given grade (e.g. 'You passed!' / 'Please review chapter 3').
Inputs: grade (required), quiz_id (required). Returns: Result of mod_quiz_get_quiz_feedback_for_grade -- schema-only, UNVERIFIED.
get_quiz_required_qtypesARead-onlyInspect
List the question types used in a quiz (e.g. 'multichoice', 'truefalse', 'essay') -- useful to know what kind of answers to expect before starting an attempt.
Inputs: quiz_id (required). Returns: result
get_recent_coursesARead-onlyInspect
Get this account's recently-accessed courses, most recent first.
Inputs: no named parameters. Returns: result
get_recent_itemsARead-onlyInspect
Get this account's recently-accessed course modules (files, assignments, etc.) across all courses, most recent first.
Inputs: no named parameters. Returns: result
get_starred_coursesBRead-onlyInspect
Get this account's starred/favourited courses, if any.
Inputs: no named parameters. Returns: result
get_unread_messagesCRead-onlyInspect
Get this account's unread PLATO notifications.
Inputs: limit. Returns: result
get_unread_notification_countARead-onlyInspect
Get a count of this account's unread notifications (a cheaper check than get_unread_messages when you don't need the content). Note: PLATO has person-to-person messaging disabled site-wide, so this counts notifications only, not conversation messages.
Inputs: no named parameters. Returns: result
get_upcoming_action_eventsARead-onlyInspect
Get Moodle's own "what needs action soon" feed -- assignments due, video lectures with a watch deadline, etc. -- sorted by urgency, from now onward. Unlike combining list_assignments + get_calendar_events, this is Moodle's own cross-activity prioritized view and may surface activity types (e.g. vod watch deadlines) those tools don't.
Inputs: limit. Returns: result
get_user_preferencesARead-onlyInspect
Get this account's Moodle user preferences. Note: most of these are internal UI state (e.g. which dashboard sections are collapsed), not information meaningful on its own.
Inputs: no named parameters. Returns: result
get_user_profileARead-onlyInspect
Get a user's profile, scoped to a shared course (not a global user search -- see docs/pii_review.md).
Inputs: course_id (required), userid. Returns: Result of core_user_get_course_user_profiles (issue #96) -- course-scoped (notโฆ
list_assignmentsARead-onlyInspect
List assignments across one or more courses, with due dates.
Inputs: course_ids (required). Returns: result
list_calendar_eventsBRead-onlyInspect
List upcoming calendar events within the next days_ahead days.
Inputs: days_ahead. Returns: result
list_chatsARead-onlyInspect
List Chat (real-time chat room) activities across one or more courses. Reading/sending chat messages is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_choicesARead-onlyInspect
List Choice (single-question poll) activities across one or more courses. Voting is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_coursesBRead-onlyInspect
List the courses the logged-in PLATO account is enrolled in.
Inputs: no named parameters. Returns: result
list_database_activitiesARead-onlyInspect
List Database ("mod_data") activities across one or more courses. Reading/adding entries is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_feedbacksARead-onlyInspect
List Feedback (survey) activities across one or more courses. Responding to a survey is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_forumsARead-onlyInspect
List standard Moodle forums across one or more courses. NOT the same as PLATO's notice/Q&A board (use list_notices/list_qna for that) -- this covers the separate, less-commonly-used mod_forum module.
Inputs: course_ids (required). Returns: result
list_glossariesARead-onlyInspect
List Glossary activities across one or more courses. Reading/ adding entries is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_h5p_activitiesARead-onlyInspect
List H5P interactive-content activities across one or more courses. Attempt results are not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_lessonsARead-onlyInspect
List Lesson activities across one or more courses. Taking a lesson (answering pages) is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_noticesARead-onlyInspect
List announcements posted to a course's Notices board.
Inputs: course_id (required). Returns: result
list_qnaBRead-onlyInspect
List questions posted to a course's Q&A board.
Inputs: course_id (required). Returns: result
list_quizzesCRead-onlyInspect
List quizzes across one or more courses.
Inputs: course_ids (required). Returns: result
list_scormsARead-onlyInspect
List SCORM packaged-content activities across one or more courses. Launching/tracking a SCORM attempt is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_surveysARead-onlyInspect
List Survey activities across one or more courses. Answering is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_video_conferencesARead-onlyInspect
List BigBlueButton video-conference activities across one or more courses. Joining a meeting is not supported by this server -- this tool is read-only coverage only. Zoom activities (mod_zoom) are not covered -- no real instance has existed to verify against.
Inputs: course_ids (required). Returns: result
list_wikisARead-onlyInspect
List Wiki activities across one or more courses. Reading/ editing pages is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
list_workshopsARead-onlyInspect
List Workshop (peer assessment) activities across one or more courses. Submitting or assessing work is not supported by this server -- this tool is read-only coverage only.
Inputs: course_ids (required). Returns: result
post_qna_questionADestructiveInspect
Post a new question to a course's Q&A board. IRREVERSIBLE and VISIBLE to the instructor once dry_run=False (posted as private/secret by default).
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm.
Inputs: subject (required), course_id (required), content_text (required), dry_run. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
process_quiz_attemptADestructiveInspect
Submit answers for a quiz attempt. IRREVERSIBLE once dry_run=False AND finish_attempt=True -- that is the final, graded submission and cannot be undone. UNVERIFIED against a real quiz.
Call with dry_run=True (default) first, show the preview to the user -- especially before finish_attempt=True -- and only call again with dry_run=False after they explicitly confirm.
Inputs: responses (required), attempt_id (required), dry_run, finish_attempt. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
remove_submissionADestructiveInspect
Withdraw/clear this account's own submission for an assignment. IRREVERSIBLE and DESTRUCTIVE once dry_run=False -- this discards already-submitted work (files/text), not a draft.
KNOWN ISSUE: live testing found dry_run=False currently fails with an "invalid parameter" error from PLATO every time (the real required parameter shape wasn't determined -- see remove_submission_for's docstring). dry_run=True (preview) works and is safe to call. Do not rely on dry_run=False actually working until this is fixed.
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm.
Inputs: course_id (required), assignment_id (required), dry_run. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
save_quiz_attempt_responsesADestructiveInspect
Save in-progress answers WITHOUT finishing the attempt -- can still be changed later. UNVERIFIED against a real quiz.
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm.
Inputs: responses (required), attempt_id (required), page, dry_run. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
search_coursesARead-onlyInspect
Search PLATO's entire course catalog by name -- not limited to this account's enrolled courses (use list_courses for that).
Inputs: search_text (required). Returns: result
start_quiz_attemptADestructiveInspect
Start a new attempt at a quiz. IRREVERSIBLE once dry_run=False -- consumes one of the quiz's limited attempts. UNVERIFIED against a real quiz -- call get_quiz_access_information first and check canattempt/preventaccessreasons.
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm.
Inputs: quiz_id (required), dry_run. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
submit_assignmentADestructiveInspect
Submit text and/or file attachments for an assignment. IRREVERSIBLE once dry_run=False.
Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False (same parameters) after they explicitly confirm. Provide text, file_paths/file_contents, or both -- whichever this assignment actually accepts (see get_assignment_detail).
file_paths works only when this server is running locally (stdio, e.g. Claude Code/Desktop) -- rejected with a clear error over a remote (streamable-http, e.g. a Claude.ai Connector) connection, mirroring download_course_file's own stdio-vs-remote split. file_contents works over either transport and is the only option remotely, since this server's disk is not reachable by you there.
Inputs: course_id (required), assignment_id (required), text, dry_run, +2 more. Returns: Standard return shape for every write tool. dry_run=True: `preview` describes wโฆ
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 67 tools
Most tools have distinct resource/action targets, and descriptions explicitly clarify several near-neighbors such as list_forums vs. list_notices/list_qna and course completion vs. activity completion. However, there is meaningful overlap among course-listing tools, grade-summary vs. grade-item tools, unread count vs. unread messages, and quiz save vs. process/submit operations, so selection remains error-prone with 67 tools.
Names are consistently snake_case and generally verb-led, which makes the surface predictable. The main inconsistency is the mix of verb families for similar operations, such as list_ vs. get_ for reads and create/add/post/submit/save/process/remove/delete for mutations.
Sixty-seven tools far exceeds the practical 3-15 range and is an extreme count for an agent-facing server. The surface is heavily fragmented into one-off list tools for many activity types, which makes the set harder to navigate even though the LMS domain is broad.
Core student workflows are covered: courses, contents, assignments, grades, quizzes, forums, calendar, notices, Q&A, and files all have read or write operations. But notable gaps remain, including no Q&A reply tool, no calendar update, no private-file delete, many read-only activity modules, and a known-broken remove_submission dry_run=False path.
Maintenance
Related MCP Connectors
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Run the Geduk LMS from an AI assistant: courses, sessions, enrolments, users and catalogue.
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides read-only access to a university's Moodle virtual campus, letting an AI assistant browse courses, sections and files, check upcoming deadlines, view assignment status and grades, and read forum announcements and threads. Authentication uses a Moodle token stored locally, with support for both undergraduate and postgraduate campus URLs.8MIT
- AlicenseNot gradedqualityCmaintenanceLets AI assistants, terminals, and other programs drive Aswaya Pradita University's Moodle LMS: viewing courses and participants, tracking assignment submissions, reading gradebooks, downloading files, and handling deadlines, plus (with explicit opt-in) posting announcements, grading, messaging, and adding or renaming course sections. Read-only tools and dry-run previews keep write actions under user control, with credentials held outside the assistant.MIT
- AlicenseAqualityBmaintenanceEnables teachers, through AI assistants, to view courses, assignments, and student submissions, download submission files, and save grades with feedback after explicit confirmation via the Moodle REST API.7112 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables an AI agent to access a Moodle Campus Virtual account with the user's own credentials, reading course content, files, forums, notices, calendar, grades and quiz attempts for every enrolled course. Teachers, managers and course creators also get access to other participants' data and to planned, verified write operations such as forums, grading, attendance, quizzes, groups, content and H5P activities.4Apache 2.0