StudentVue

Provides access to StudentVue data from your MCP client via a local server with portal, username, and password credentials.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "plyght-studentvue": {
      "command": "node",
      "args": [
        "/absolute/path/to/studentvue/packages/studentvue-mcp/dist/index.js"
      ],
      "env": {
        "STUDENTVUE_PORTAL": "https://your-district.edupoint.com",
        "STUDENTVUE_PASSWORD": "your_password",
        "STUDENTVUE_USERNAME": "your_username"
      }
    }
  }
}

You can run the StudentVue MCP Server locally to bridge StudentVue data with your AI assistant. It lets you request your current grades and portal data through your preferred MCP client, while keeping credentials and portal details securely configured on your machine.

How to use

Use your MCP client to connect to the StudentVue MCP Server you configured. Once the server is running, you can ask your AI assistant to retrieve information such as your current grades or portal-related details. The server exposes a standard MCP interface, so you can request data by name and the client will relay your queries to the local server and return the results.

How to install

Prerequisites you need before installation are Node.js and Bun for running the MCP server. Install a recent version of Node.js from nodejs.org and Bun from bun.sh. You will also need a district StudentVue portal URL along with your username and password.

# Install Bun if not present
curl https://bun.sh/install | bash

# Optional: verify Bun is installed
bun --version

# Install dependencies for the StudentVue MCP project (example path shown)
bun install

# Build the project (example path shown)
bun run build

Configuration steps

After building, create a configuration that points to your local MCP server and your StudentVue credentials.

{
  "mcpServers": {
    "studentvue_node": {
      "command": "node",
      "args": ["/absolute/path/to/studentvue/packages/studentvue-mcp/dist/index.js"],
      "env": {
        "STUDENTVUE_PORTAL": "https://your-district.edupoint.com",
        "STUDENTVUE_USERNAME": "your_username",
        "STUDENTVUE_PASSWORD": "your_password"
      }
    }
  }
}

Verify the server is running and test

Start the MCP server using your chosen method, then confirm it is listening on the expected port. You can verify by making a simple query through your MCP client or by checking logs.

# Example: start the server using the standard runtime
node /absolute/path/to/studentvue/packages/studentvue-mcp/dist/index.js

Security notes

Do not expose your StudentVue credentials publicly. Keep credentials in secure environment variables or a password manager. The MCP server runs locally and does not automatically transmit your data to external services.

Troubleshooting

If the server does not respond, verify that the build completed successfully, the configuration contains your correct portal URL and credentials, and Node.js is installed and accessible.

# Check that the built dist file exists
ls -la /absolute/path/to/studentvue/packages/studentvue-mcp/dist/index.js

# Check Node.js version
node --version

Generating Custom Install Links

You can create custom install links that embed your MCP configuration by base64 encoding your config JSON and constructing a special URL. This makes it easy to share a preconfigured setup with your team.

# Example base64 encoding of a server config (without the server name wrapper)
echo -n '{"command":"node","args":["/path/to/dist/index.js"],"env":{"STUDENTVUE_PORTAL":"https://your-district.edupoint.com","STUDENTVUE_USERNAME":"","STUDENTVUE_PASSWORD":""}}' | base64

Built by

VeilStrat

AI signals for GTM teams