simple-hackathon-ops-mcp
Allows managing a GitHub organization for hackathon operations, including creating teams and repositories, assigning team leads as maintainers, locking and unlocking at deadlines, granting read-only access to mentors and judges, assessing app installation requests, and toggling schedules through a plan-confirm-apply workflow.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
SimpleHackathon-ops
해커톤 운영 오픈소스 키트입니다. 참가 신청 폼으로 신청을 받고, MCP 서버로 GitHub org를 운영합니다. 운영진은 Claude에게 말로 시키고, GitHub을 바꾸는 일은 항상 "계획 → 확인 → 적용" 순서로만 일어납니다.
처음 쓴 대회는 ENDPoinT 2026(서울과학기술대학교 컴퓨터공학과 해커톤)입니다.
들어 있는 것
폴더 | 무엇 | 스택 |
참가 신청 페이지. ENDPoinT 사이트의 신청 화면을 디자인 그대로 옮겼습니다. GitHub 아이디까지 받고, 서버가 기간·입력을 검사해 구글 시트에 씁니다 | HTML·CSS·JS(빌드 없음), GitHub Pages, Google Apps Script, Google Sheets | |
MCP 서버 | TypeScript, Node.js 22+, MCP SDK, zod, Octokit, node:sqlite | |
대회 설정 양식, 앱 정책, 팀 README 양식, 환경 변수 목록 | YAML | |
그림과 문서 |
Related MCP server: ghe-mcp-gateway
빠른 시작
신청 받기:
packages/forms대로 시트에 Apps Script를 붙이고,site/를 GitHub Pages에 올립니다. 질문·모집 기간은Config.gs, 대회 이름·안내 글은site/config.js에서 고칩니다.MCP 연결: GitHub App을 만들어 대회 org에 설치하고, Claude Code나 Claude Desktop에 서버를 등록합니다.
claude mcp add simple-hackathon-ops --scope user \ -e HACKATHON_OPS_HOME=$HOME/hackathon-ops \ -e GITHUB_APP_ID=123456 -e GITHUB_APP_PRIVATE_KEY_PATH=/path/to/key.pem \ -- npx -y simple-hackathon-ops-mcp운영: "새 대회 만들어줘, 명단은 이 시트로" → "명단 확인해줘" → "팀 만들고 초대해줘" → "마감 잠가줘"처럼 말합니다. 바뀔 목록을 먼저 보여 주고, 확인한 뒤에만 적용합니다. 자세한 흐름은
packages/mcp에 있습니다.
지키는 것
GitHub 변경은 계획을 먼저 보여 주고 확인 코드가 있어야 적용됩니다. 그사이 상황이 바뀌면 적용하지 않습니다.
참가자가 다른 팀 코드를 볼 수 없게 합니다. 멘토·심사위원은 읽기만, 마감 전에는 public 전환을 막습니다.
명단은 읽기만 하고, 도구 응답에 이메일을 내보내지 않습니다. 대회가 끝나면 로컬 기록의 개인정보를 지웁니다.
앱 승인과 2FA 강제처럼 GitHub이 API를 열어 두지 않은 일은 사람이 GitHub 화면에서 합니다. 도구는 판단 근거와 링크를 줍니다.
개발
npm install # 저장소 루트에서 (npm workspaces)
npm test # MCP 66개 + 폼 17개 테스트
npm run typecheck
npm run build
npm run smoke # 빌드된 MCP 서버를 실제 MCP 클라이언트로 띄워 확인.
├── packages/
│ ├── mcp/ MCP 서버 (npm: simple-hackathon-ops-mcp)
│ └── forms/ 신청 페이지: site/ (GitHub Pages) + apps-script/ (Apps Script)
├── config/ 설정 양식 (event.example.yaml, app-policy.yaml, …)
├── docs/ 그림
└── workspace/ 내 대회 설정과 기록 (git 제외)기여 방법은 CONTRIBUTING.md를 보세요.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Run hackathons end to end: events, teams, submissions, judging and winners.
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Manage repositories, users, releases, and automate GitHub workflows
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage GitHub repositories, branches, issues, pull requests, releases, and actions through natural language.6MIT
- FlicenseBqualityDmaintenanceEnables natural language admin tasks for GitHub Enterprise Cloud, like listing private repos, access reviews, and secret scanning, with read-only safety by default.21-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform GitHub operations such as creating repositories, issues, pull requests, and more through natural language.-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to answer natural-language GitHub queries by listing repositories, issues, pull requests, branches, commits, and files, as well as performing writes with dry-run and confirmation safeguards.-