convez.ai
MCP ServerIntegração & APIsIntermediário
sarvea45

MCP Server de Catálogo Universitário

sarvea45/Model-Context-Protocol-MCP-Server-for-a-University-Course-Catalog

Catálogo universitário em protocolo MCP para LLMs consultar cursos e pré-requisitos

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe o catálogo de cursos de uma universidade para LLMs, permitindo buscas, consultas de pré-requisitos e análise de dependências entre disciplinas. Implementado em Python com FastAPI, SQLAlchemy e NetworkX, funcionando como backend para um assistente acadêmico de IA.

Instalação

$npx convez-ai sarvea45/Model-Context-Protocol-MCP-Server-for-a-University-Course-Catalog

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Assistentes acadêmicos que consultam catálogo de cursos via IA
  • Planejamento de grade horária com análise de pré-requisitos
  • Busca e comparação de disciplinas por department ou conteúdo

Veredito

Implementação sólida de MCP server demonstrando padrões corretos de integração com LLMs, bem estruturada com Docker, persistência em SQLite e análise de grafos de dependências. Útil como referência técnica e base para sistemas de consultoria acadêmica.

README

A tradução para o português deste README ainda está na fila.

University Course Catalog MCP Server

A Model Context Protocol (MCP) server exposing a university course catalog to Large Language Models (LLMs). This project acts as the backend for an AI-powered academic advisor, demonstrating how to use the MCP specification, define tools and resources, and manage state securely with a SQLite database.

Technologies Used

  • Python 3.12
  • FastAPI (for HTTP and SSE transport)
  • Model Context Protocol (MCP) SDK
  • SQLAlchemy (Database ORM)
  • Pydantic (Data validation)
  • NetworkX (Graph resolution for prerequisites)
  • Docker & Docker Compose (Containerization)

Getting Started

1. Prerequisites

Ensure you have Docker and Docker Compose installed on your system.

2. Environment Variables

An .env.example file is provided in the repository root. Ensure the database URL is correctly configured:

DATABASE_URL=sqlite:///./data/catalog.db
PORT=8080

3. Running the Server

You can launch the entire system using Docker Compose. This command builds the image, runs the database seed script automatically, and mounts the data/ volume for database persistence:

docker-compose up --build -d

The server will be available at http://localhost:8080. Docker Compose will also execute an automated healthcheck.

MCP Capabilities

Tools

  • search_courses: Searches the university course catalog for courses matching a query string. Can optionally filter by a specific department code.
  • get_prerequisites: Retrieves the direct prerequisites for a given course code.
  • lookup_instructor: Finds an instructor's details (Name, Email, Department) by their name.
  • get_prerequisite_graph: Returns the full, multi-level dependency graph (nodes and edges) for a given course using NetworkX.

Resources

  • course-catalog://course_descriptions: A formatted text resource containing all courses and their descriptions.
  • course-catalog://department_directory: A formatted text resource listing all academic departments and their codes.

Prompt Templates

  • course_comparison_template: A prompt template requesting the LLM to generate a structured comparison between two specific courses using their course codes.

Testing Locally

You can test the MCP server functionality by connecting the official MCP Inspector CLI to the server:

npx @anthropic-ai/inspector http://localhost:8080/sse

From the inspector, you can invoke tools, fetch resources, and render prompt templates interactively.

Ver o original no GitHub

Bom para

Relacionados