School Attendance MCP Server

# All MCP Tools Summary ## Total Tools: 7 ### 1. mark_attendance Mark attendance for a student with date and status. **Parameters:** - `studentId` (string, required) - `date` (string, required) - Format: YYYY-MM-DD - `status` (string, required) - Values: "present", "absent", "late" --- ### 2. get_repo_info Get information about a GitHub repository. **Parameters:** - `repoOwner` (string, required) - `repoName` (string, required) **Returns:** Name, owner, default branch, description, stars, forks, private status --- ### 3. list_branches List all branches in a GitHub repository. **Parameters:** - `repoOwner` (string, required) - `repoName` (string, required) **Returns:** List of branches with names, protection status, and SHAs --- ### 4. create_branch Create a new branch in a GitHub repository. **Parameters:** - `repoOwner` (string, required) - `repoName` (string, required) - `branchName` (string, required) - `baseBranch` (string, optional) - Default: "main" **Note:** Creates a new branch - use carefully! --- ### 5. get_file_contents Get the contents of a file from a GitHub repository. **Parameters:** - `repoOwner` (string, required) - `repoName` (string, required) - `filePath` (string, required) - `branch` (string, optional) - Default: default branch **Returns:** File content, size, SHA, and metadata --- ### 6. list_commits List recent commits in a GitHub repository. **Parameters:** - `repoOwner` (string, required) - `repoName` (string, required) - `branch` (string, optional) - Default: default branch - `perPage` (number, optional) - Default: 10, Max: 100 **Returns:** List of commits with SHA, message, author, date, and URL --- ### 7. commit_changes Commit files to a GitHub repository. **Parameters:** - `repoOwner` (string, required) - `repoName` (string, required) - `branchName` (string, required) - `commitMessage` (string, required) - `filesToCommit` (array, required) - Array of `{path, content}` objects **Note:** Commits files to repository - use carefully! --- ## Quick Test Commands See `CURL_TEST_COMMANDS.md` for detailed curl commands for each tool. ## Testing All Tools Run the comprehensive test script: ```bash ./test-all-tools.sh ``` ## Important Notes 1. **Restart server** after adding new tools: `npm run start` 2. **GitHub token required** for all GitHub tools (set in `.env`) 3. **Read-only tools** (safe to test): `get_repo_info`, `list_branches`, `get_file_contents`, `list_commits` 4. **Write operations** (test carefully): `create_branch`, `commit_changes`