Studentvue

🚀 StudentVue Monorepo

A comprehensive StudentVue API implementation offering both a Rust library and a Model Context Protocol (MCP) server. It allows access to student information, grades, attendance, messages, and more through native Rust or AI - powered applications.

🚀 Quick Start

Rust API

cd packages/studentvue-api
cargo build --release

Add the following to your Cargo.toml:

[dependencies]
studenvue = "0.1.0"
tokio = { version = "1.35", features = ["full"] }

💻 Usage Examples

Basic Usage

use studenvue::{StudentVueClient, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let client = StudentVueClient::new(portal, username, password);
    let info = client.get_student_info().await?;
    println!("Student: {} (Grade {})", info.name, info.grade);
    Ok(())
}

MCP Server

Quick Install for Cursor

Manual Installation

cd packages/studentvue-mcp
bun install
bun run build

See packages/studentvue-mcp/INSTALL.md for complete installation instructions for Claude Desktop, Cursor, and other MCP clients.

✨ Features

📦 StudentVue Rust API

• Type - safe data models: With proper error handling.
• Async/await support: Via Tokio runtime.
• Automatic SOAP envelope construction and XML parsing: Simplify the interaction with the SOAP API.
• Multiple API endpoints: 15+ fully implemented API endpoints.
• Production - ready: With comprehensive test coverage.

Location:

📦 StudentVue MCP Server

• Exposed API endpoints: 15+ StudentVue API endpoints exposed as MCP tools.
• Built with official SDK: Built with the official MCP TypeScript SDK.
• Seamless integration: Seamless integration with Claude Desktop and other MCP clients.
• Secure credential handling: Via environment variables.

Location:

📚 Documentation

• Monorepo Guide - Working with the monorepo
• Contributing Guide - Development workflow and standards
• Rust API Documentation
• MCP Server Documentation
• MCP Protocol Documentation

🔧 Technical Details

Available API Methods

Both packages provide access to the following StudentVue features:

Development

Workspace Commands

make build          # Build all packages
make test           # Run all tests
make format         # Format all code
make lint           # Run all linters
make typecheck      # Run type checking
make quality-gates  # Run all quality checks
make clean          # Clean build artifacts
make install        # Install dependencies

Per - Package Development

Rust API:

cd packages/studentvue-api
cargo build && cargo test

MCP Server:

cd packages/studentvue-mcp
bun install && bun run build && bun test

Project Structure

studentvue/
├── packages/
│   ├── studentvue-api/      # Rust API library
│   │   ├── src/             # Source code
│   │   ├── tests/           # Integration tests
│   │   └── examples/        # Usage examples
│   └── studentvue-mcp/      # MCP server
│       ├── src/             # TypeScript source
│       └── dist/            # Built artifacts
├── docs/                    # Documentation
├── Cargo.toml               # Rust workspace config
├── Makefile                 # Build automation
└── README.md                # This file

Configuration

Both packages require StudentVue credentials via environment variables:

STUDENTVUE_PORTAL=https://your-district.edupoint.com
STUDENTVUE_USERNAME=your_username
STUDENTVUE_PASSWORD=your_password

⚠️ Important Note

Never commit credentials to version control. Always use environment variables or .env files (gitignored by default).

🧪 Testing

Both packages include comprehensive test suites:

cd packages/studentvue-api && cargo test
cd packages/studentvue-mcp && bun test

Set up test credentials in .env files before running tests.

👥 Contributing

Contributions are welcome. Please see our Contributing Guide for details. All contributions must:

• Be formatted properly (rustfmt for Rust, Prettier for TypeScript).
• Pass all lints (clippy for Rust, ESLint for TypeScript).
• Pass all tests.
• Include tests for new features.

📋 Use Cases

For Developers (Rust API)

• Build custom StudentVue integrations.
• Create mobile apps with native performance.
• Automate grade monitoring and notifications.
• Integrate with school management systems.

For AI Applications (MCP Server)

• Enable Claude to answer questions about grades.
• Get natural language summaries of attendance.
• Ask about upcoming assignments and events.
• Retrieve and explain report cards.

📄 License

MIT

🙏 Acknowledgments

Based on reverse - engineering and documentation of the StudentVue SOAP API by the community.