MCP Academia Server

The MCP Academia Server is a centralized server that manages and queries gym exercises. It exposes a set of HTTP and local stdin interfaces to fetch workout data, enabling multiple solutions to reuse a single MCP backend without duplicating logic. You can interact with it via HTTP requests or run it locally through a stdio workflow, making it easy to integrate into your fitness applications or coaching tools.

How to use

You can use the MCP Academia Server from a client by sending commands over HTTP or by running it locally and piping input to it. The server exposes a collection of tools for querying exercise data, such as filtering by muscle group, looking up exercises by name, listing all exercises, and fetching detailed information for a specific exercise.

How to install

Prerequisites: you need Docker installed on your machine to build and run the official container. If you prefer a direct host run, you should have a Node.js and npm environment available for any local setup shown in examples.

Step 1: Build the Docker image from the provided Dockerfile in your project directory.

docker image build \
    --pull -t mcp-server-academia .

Step 2: Run the container to start the MCP server and expose the HTTP endpoint on port 3000.

docker container run \
    --rm --name mcp-server-academia \
    -d -p 3000:3000 mcp-server-academia

Additional notes

The server provides the following HTTP endpoint and stdio workflow for interaction. Use the HTTP approach when you want to drive the MCP server from another service or a web-based client. Use the stdio approach to embed the server directly in a local script or when testing without network calls.

HTTP usage example (conceptual): you send a POST request to the server URL with the appropriate payload to invoke a tool or query. stdio usage example (conceptual): you pipe a JSON payload into the runtime command to interact with the local server.

Available tools

buscar_exercicios_por_grupo

Search exercises by muscle group. Available groups include Back, Shoulders, Legs, Chest, and Arms. Input: {grupo_muscular: string}. Output: List of exercises with sets, reps, rest, and notes.

listar_grupos_musculares

List all available muscle groups in the database. Input: none. Output: List of muscle groups.

buscar_exercicio_por_nome

Search exercises by name with partial, case-insensitive matching. Input: {nome: string}. Output: Matching exercises with details.

listar_todos_exercicios

List all registered exercises, grouped by muscle group. Input: none. Output: Full catalog of exercises.

obter_detalhes_exercicio

Get complete details for a specific exercise by its ID. Input: {id: number}. Output: Detailed exercise information.