viccios/mcp-server-timetable-restinga-fetcher
If you are the rightful owner of mcp-server-timetable-restinga-fetcher and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This project is a Python-based MCP server using the FastMCP library, designed to integrate Timetable Restinga Fetcher data with a Language Model.
get_teachers
Returns the name of all teachers
get_subjects
Returns the name of all subjects
get_classrooms
Returns the number of all classrooms
get_classes
Returns the name of all courses
get_periods
Returns the schedule of each period
get_dayparts
Returns all parts of the day
get_dates
Returns all dates
get_event_types
Returns all event types
MCP Server Timetable Restinga Fetcher
Sumário
🧠 Sobre
Este projeto é uma implementação de um servidor MCP escrito em Python com a biblioteca FastMCP.
💭 Como funciona
Este servidor expõe 8 ferramentas (tools) para clientes MCP, permitindo a integração dos dados fornecidos pelo Timetable Restinga Fetcher a uma LLM.
💪 Instalação
Esse projeto é gerenciado com uv, um gerenciador de pacotes e projetos para Python. Leia a página de instalação do uv para informações sobre como instalá-lo e certifique-se de que o Python está disponível também. Após isso, clone o repositório, instale as dependências com o comando uv sync, ative o ambiente virtual (venv), crie um arquivo .env ou copie o existente cp .env.example .env e então inicie o servidor com o comando fastmcp run main.py:mcp ou fastmcp dev main.py:mcp para o modo de desenvolvimento (irá instalar o Inspector).
📜 Documentação
Ferramentas
Atualmente, 8 ferramentas são expostas pelo servidor MCP.
| Ferramenta | Descrição |
|---|---|
get_periods | Retorna os períodos das aulas |
get_subjects | Retorna as disciplinas |
get_teachers | Retorna os professores |
get_classes | Retorna as turmas |
get_classrooms | Retorna as salas de aula |
get_class_schedule | Retorna as turmas com informações detalhadas sobre os horários |
get_teachers_schedule | Retorna os professores com informações detalhadas sobre suas turmas, salas de aula e horários |
get_classrooms_schedule | Retorna as salas de aula com informações detalhadas sobre as turmas, professores e horários |
É necessário configurar a URL da API do Timetable Restinga Fetcher através do arquivo .env.
Um exemplo de configuração está disponível no arquivo .env.example.
Usando em um cliente
Para usar o servidor MCP, é necessário configurá-lo em um cliente MCP que suporte tools. Abaixo está um exemplo de arquivo JSON de conexão para o Cursor (sistemas Unix-like). Use caminhos absolutos.
{
"mcpServers": {
"mcp-server-timetable-restinga-fetcher": {
"command": "/home/<seu-usuario>/<pasta-projeto>/.venv/bin/python",
"args": [
"/home/<seu-usuario>/<pasta-projeto>/mcp-server-timetable-restinga-fetcher/main.py"
]
}
}
}