MCP 프로젝트 — 마감일 / 수업 일정 트래커

MCP 과목의 대형 과제 (FIT-HCMUS, 강사 Kha Do) — 슬라이드 MCP — Plug Your Agent Into Everything 기반.

구조

mcp-homework/
├── server/
│   ├── core.js     ← logic MCP thật: 3 tools + 1 resource + 1 prompt
│   ├── server.js   ← chạy core qua stdio
│   └── http.js      ← chạy core qua Streamable HTTP + API key guard + /health
├── agent/
│   ├── host.js     ← agent = MCP HOST (load config, merge tools, dispatch, use_skill)
│   └── config.json ← khai báo model + các MCP server cần nối + nơi chứa skills
├── skills/
│   └── deadline-review/SKILL.md ← 1 skill orchestrate tool của server
└── README.md

Related MCP server: ScienceTokyoLMS-mcp

서버 주제: 마감일 / 수업 일정 트래커

• Tools

  • add_deadline({ title, subject, due }) — 마감일 추가

  • list_deadlines({ subject?, onlyPending? }) — 필터링하여 나열

  • complete_deadline({ id }) — 완료 처리, id가 틀리면 isError: true 반환

• Resource: deadline://list — 전체 목록, 읽기 전용

• Prompt: plan_my_week — 모델이 현재 마감일을 바탕으로 주간 계획을 세우도록 요청

각 부분 실행

1. stdio 서버 (Inspector로 테스트)

npm install
npx @modelcontextprotocol/inspector node server/server.js

2. HTTP 서버 (로컬, 이후 공개 배포)

MCP_KEY=$(openssl rand -hex 32) node server/http.js
# test:
npx @modelcontextprotocol/inspector   # chọn Streamable HTTP, URL http://localhost:3000/mcp,
                                       # header Authorization: Bearer <MCP_KEY>

배포 (Render/Fly/Railway...): 환경 변수 MCP_KEY 설정, PORT 포트 노출, /health는 플랫폼의 health check에 사용됩니다.

3. Agent host (두 서버 + skill 모두 사용)

cd agent && npm install
# cần Ollama chạy sẵn model qwen3.5:4b (hoặc đổi model/baseURL trong config.json)
node host.js "deadline tuần này của tôi thế nào?"

host.js는: stdio 서버 + HTTP 서버 연결 → tool 목록 병합 → skills/에서 skill index 구축 → think/decide/act/observe 루프 실행, 질문이 skill 설명과 일치하면 use_skill을 자동 호출한 뒤 해당 MCP tool을 호출합니다.

자체 테스트 완료

• stdio 서버 smoke test: 3개 tool 모두 호출, resource 읽기, prompt 가져오기, 존재하지 않는 id를 complete 처리할 때 isError 확인 — 모두 예상대로 동작.

• HTTP 서버: key가 없는 request → 401; 올바른 key가 있으면 → initialize handshake 성공; /health는 ok 반환.

제출 전에 해야 할 일

• HTTP 버전을 공개 플랫폼에 배포 (Render/Fly/Railway/Cloudflare Workers…), MCP_KEY 설정, 채점자용 URL + key 기록

• Ollama 설치 + qwen3.5:4b pull, 실제 모델로 agent/host.js 실행 테스트 (위 테스트는 MCP 계층만 검증했으며 LLM은 호출하지 않음)

• 짧은 데모 영상 촬영 (아래 "제출" 항목 참조)