FIT Courses MCP
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.
FIT Courses MCP
An independent MCP server for the FIT CTU course catalogue and teaching materials. Use it with Codex, Claude Code, OpenCode or Antigravity CLI (agy) to search and browse course sites. Each client runs the server locally over stdio.
Install
From this checkout, with Python 3.11 or later on Linux or macOS, run
python3 -m venv .venv
.venv/bin/python -m pip install .
.venv/bin/playwright install chromiumAn existing google-chrome or chromium on PATH also works. Browser support is used for semester discovery, login and interactive renewal. Catalogue search, known-semester reads and valid cookie reads use HTTP directly. On a minimal Linux system, Playwright can install Chromium's system dependencies with playwright install --with-deps chromium.
Related MCP server: Courses MCP Server
Connect a client
To try public materials without signing in, run the corresponding command from this repository. The shell expands the executable path during registration, so the MCP works when launched from another directory.
codex mcp add fit-courses -- "$PWD/.venv/bin/fit-courses-mcp"
claude mcp add --transport stdio fit-courses -- "$PWD/.venv/bin/fit-courses-mcp"
opencode mcp add fit-courses -- "$PWD/.venv/bin/fit-courses-mcp"
agy mcp add fit-courses -- "$PWD/.venv/bin/fit-courses-mcp"Claude Code and OpenCode register in the current project by default. Use claude mcp add --scope user or opencode mcp add fit-courses --global with the same server command to register across projects. Open a fresh client session after registration. In OpenCode v2, use /mcps to check the connection if the tools are still loading.
The agy mcp add command registers the server for your user account. Run agy mcp list to verify registration and use /mcp inside agy to check the live connection. For workspace-only setup, use .agents/mcp_config.json with an entry under mcpServers.fit-courses. Set command to the absolute executable path and use args for any server arguments. Antigravity MCP documentation
Codex 0.169.0, Claude Code 2.1.295, OpenCode 2.3.0 and Antigravity CLI 1.5.9 each retrieved the live catalogue entry for BI-ML1.21 in smoke tests. The OpenCode check used direct tools, enabled with "codemode": false in the mcp.servers.fit-courses entry.
Access protected materials
Your MCP client receives page text, search snippets, and PDF extracts. Depending on your client and model settings, retrieved content may be sent to a hosted AI provider and retained in conversation history. Before reading protected materials, check whether the course rules and your provider's data settings allow that use. CTU guidelines for AI in study and teaching
Use an existing private .env or copy .env.example into a new one. Set permissions with chmod 600 .env. To load the file, append --env-file "$PWD/.env" after the executable in your client setup command above, or add ["--env-file", "/absolute/path/to/.env"] as the server arguments in your client configuration. Reopen the client session after updating the registration.
Mode | What goes in the file |
Cookie | Sign in to Courses in your browser. In developer tools, select cookies for |
Password | Set |
When both are present, the server tries the cookie first. When FIT rejects it, the server asks for permission to sign in again. Approval lasts for this MCP connection. It uses the saved credentials if available or opens FIT login in a separate browser window. A decline lasts until the client restarts the server. Clients with MCP form elicitation show their own consent prompt. The fallback opens a local browser confirmation window. Headless users without an elicitation-capable client can replace the cookie in the private file and restart. Renewed cookies live in process memory. Environment variables override the file. Use the local configuration file or browser for all secret values.
Use the tools
Try “Find BI-ML1.21 and show me its lecture pages” or “Find BI-3DT.1 in B232 and open its archived homepage.”
Tool | How to use it |
| See published semester choices. |
| Search by code or Czech/English name. Use |
| Supply an exact course code and optional title query. Results include breadcrumbs. |
| Search for a word or phrase inside one course's HTML pages. Results include matching snippets and source URLs. Follow |
| Start with the course code, then follow a returned page URL in the same session and snapshot. Supply a heading or text offset for long pages. |
| Supply the course code and a discovered attachment URL. For a PDF, request an inclusive one-based page range. Continue a partial page with both |
| Inspect configured mode, last authentication outcome and renewal permission. |
External sites are returned as links. PDF text extraction uses a bounded worker and reports image-only pages. Course content search scans up to 100 HTML pages with a 20-second crawl budget after loading the homepage. If complete is false, the result covers only the pages the crawl could read. To sign in for a protected subpage, open it directly with read_page and retry the search.
Development
.venv/bin/python -m pip install -e '.[test]'
.venv/bin/python -m pytest -qThe offline tests use synthetic credentials and materials.
To rerun the packaged stdio smoke test against FIT, run FIT_COURSES_LIVE=1 .venv/bin/python -m pytest -q tests/test_live.py. Add FIT_COURSES_LIVE_ENV_FILE="$PWD/.env" to test a protected read using the credentials or cookie configured there. This check uses BI-ML1.21, the B232 archive and, when enabled, BIE-BEK.21.
License
The project code is available under the MIT License. Course materials remain subject to their respective rights and terms.
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
Federated search of books and papers, BibTeX/RIS citations, open-access retrieval and reading.
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
Unofficial NTNU course data: search, timetables, grades, course info, and exam logistics.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides full-text search and context retrieval from university course materials (PDF, PPTX, DOCX) offline after indexing.-
- FlicenseNot gradedqualityBmaintenanceEnables LLMs to interact with FIT CTU course materials, including listing subjects, navigating subpages, reading content as Markdown, and performing keyword searches.-
- AlicenseBqualityBmaintenanceEnables users to query official undergraduate and graduate course schedules, indexes, prerequisites, and exam timetables, including tools for comparing indexes and finding matching schedules. It is read-only, local, and supports filtering by days, times, lesson types, teaching weeks, and schedule clashes.7211 PyPI1MIT
- AlicenseNot gradedqualityCmaintenanceEnables read-only access to a user's university course documents through their existing account, supporting course listing, file browsing, PDF text extraction, and slide rendering.1MIT