qualis

QualisMcp exposes an MCP server for retrieving and querying Qualis classification data (specifically for the 2017-2020 period). The server offers tools to view general information about Qualis classifications (Sobre) and to look up the classification of a specific event by its acronym (Qualis). Clients communicate with the server using the MCP protocol, enabling structured requests and responses for event classifications and lookups. To use it, run the server (for example via Docker) and configure an MCP client to point at the server endpoint; then use the Sobre and Qualis tools provided by the client to retrieve data.

Available tools:

• Sobre: Fetches general information about event classifications for 2017-2020.
• Qualis: Retrieves the classification for a specific event by its acronym. These tools are designed to be used from the MCP client setup (e.g., within VS Code MCP client or another MCP-enabled client) and will return structured data describing classifications, ranks, and relevant metadata.

Prerequisites:

• Docker (for containerized deployment) or a compatible MCP runtime
• Optional: .NET SDK if you prefer a non-containerized local build or client development

Installation (Docker):

1. Install Docker on your system.
2. Pull and run the Qualis MCP server image: docker pull yanjustino/qualis-mcp-server docker run -d --name qualis-mcp -p 8080:8080 yanjustino/qualis-mcp-server
3. Verify the server is running by checking logs: docker logs -f qualis-mcp

Alternative (build from source, if provided):

1. Clone the repository: git clone https://github.com/yanjustino/qualis-mcp-server.git
2. Navigate to the project directory and build according to the project language/tooling (e.g., dotnet build for .NET projects).
3. Run the server locally according to the produced artifact (executable or runtime command).

Environment and configuration tips:

• If your MCP client requires a specific host/port, expose the container port accordingly (e.g., -p 8080:8080) and configure the client to target http://<host>:8080.
• If you run behind a reverse proxy or load balancer, ensure MCP protocol compatibility and proper routing.
• The Qualis data covers the 2017-2020 period; verify data currency if expanding to other periods.
• For troubleshooting, consult container logs and ensure Docker runtime has sufficient memory/CPU resources.
• The repository mentions Docker support and a dedicated client setup (VS Code MCP client) for configuring and running the client against the server.