learnhouse-mcp-server 1.0.0 → 1.0.2

package/dist/apply_aesthetics.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/apply_aesthetics.js

@@ -0,0 +1,40 @@
+import { LearnHouseClient } from "./client.js";
+import fs from "node:fs";
+import path from "node:path";
+const config = {
+    baseUrl: process.env.LEARNHOUSE_URL || "http://localhost:3000",
+    email: process.env.LEARNHOUSE_EMAIL || "",
+    password: process.env.LEARNHOUSE_PASSWORD || "",
+    orgId: parseInt(process.env.LEARNHOUSE_ORG_ID || "1", 10),
+};
+async function main() {
+    const client = new LearnHouseClient({
+        baseUrl: config.baseUrl,
+        orgId: config.orgId,
+    });
+    console.log("Logging in...");
+    await client.login(config.email, config.password);
+    // 1. Upload Thumbnail to Mastering MCP
+    const courseUuid = "course_d6d76f09-c553-4f82-ab81-82a1c69fdd5f";
+    const imagePath = "\\\\192.168.2.108\\Users\\Laptop\\Desktop\\Projects\\Studies\\Winter_2026\\01_SIA 3000 - Projet integrateur\\AgentOne_Project\\_Handover\\Hero\\1_Hero_Backgrounds\\hero_grid_08_circuit_grid.png";
+    if (fs.existsSync(imagePath)) {
+        console.log(`Uploading thumbnail: ${imagePath}`);
+        const buffer = fs.readFileSync(imagePath);
+        const fileName = path.basename(imagePath);
+        const updatedCourse = await client.uploadCourseThumbnail(courseUuid, buffer, fileName);
+        console.log(`✅ Thumbnail uploaded! URL: ${updatedCourse.thumbnail_image}`);
+    }
+    else {
+        console.warn(`⚠️ Image not found: ${imagePath}`);
+    }
+    // 2. Create Collection
+    console.log("Creating collection 'Artemis AI Core Protocols'...");
+    const collection = await client.createCollection({
+        name: "Artemis AI Core Protocols",
+        description: "Foundational protocols and frameworks for the Agentic Internet.",
+        courses: [16], // Mastering MCP
+        public: true,
+    });
+    console.log(`✅ Collection created! UUID: ${collection.collection_uuid}`);
+}
+main().catch(console.error);

package/dist/client.d.ts

@@ -0,0 +1,171 @@
+/**
+ * LearnHouse API Client
+ *
+ * A TypeScript client for interacting with the LearnHouse LMS API.
+ */
+import { LearnHouseConfig, LoginResponse, User, Organization, Course, CourseCreate, CourseUpdate, FullCourse, Chapter, ChapterCreate, ChapterUpdate, Activity, ActivityCreate, ActivityUpdate, Collection, CollectionCreate, TrailProgress, ActivityStatus, SearchResult } from "./types.js";
+export declare class LearnHouseClient {
+    private config;
+    private accessToken?;
+    constructor(config: LearnHouseConfig);
+    private request;
+    private get;
+    private post;
+    private put;
+    private delete;
+    private postForm;
+    private putForm;
+    /**
+     * Login with email and password
+     */
+    login(email: string, password: string): Promise<LoginResponse>;
+    /**
+     * Get current access token
+     */
+    getAccessToken(): string | undefined;
+    /**
+     * Set access token manually
+     */
+    setAccessToken(token: string): void;
+    /**
+     * Get current authenticated user
+     */
+    getCurrentUser(): Promise<User>;
+    /**
+     * List all organizations
+     */
+    listOrganizations(): Promise<Organization[]>;
+    /**
+     * Get organization by ID
+     */
+    getOrganization(orgId: number): Promise<Organization>;
+    /**
+     * Get organization by slug
+     */
+    getOrganizationBySlug(slug: string): Promise<Organization>;
+    /**
+     * List courses for the configured organization
+     */
+    listCourses(page?: number, limit?: number): Promise<Course[]>;
+    /**
+     * Get course by UUID
+     */
+    getCourse(courseUuid: string): Promise<Course>;
+    /**
+     * Get course by numeric ID
+     */
+    getCourseById(courseId: number): Promise<Course>;
+    /**
+     * Get course with full metadata (chapters & activities)
+     */
+    getCourseMeta(courseUuid: string, withUnpublished?: boolean): Promise<FullCourse>;
+    /**
+     * Create a new course
+     */
+    createCourse(course: CourseCreate): Promise<Course>;
+    /**
+     * Update a course
+     */
+    updateCourse(courseUuid: string, updates: CourseUpdate): Promise<Course>;
+    /**
+     * Upload a course thumbnail
+     */
+    uploadCourseThumbnail(courseUuid: string, imageBuffer: Buffer, fileName: string, type?: "IMAGE" | "VIDEO"): Promise<Course>;
+    /**
+     * Delete a course
+     */
+    deleteCourse(courseUuid: string): Promise<void>;
+    /**
+     * Get chapter by ID
+     */
+    getChapter(chapterId: number): Promise<Chapter>;
+    /**
+     * List chapters for a course
+     */
+    listChapters(courseId: number, page?: number, limit?: number): Promise<Chapter[]>;
+    /**
+     * Create a new chapter
+     */
+    createChapter(chapter: ChapterCreate): Promise<Chapter>;
+    /**
+     * Update a chapter
+     */
+    updateChapter(chapterId: number, updates: ChapterUpdate): Promise<Chapter>;
+    /**
+     * Delete a chapter
+     */
+    deleteChapter(chapterId: number): Promise<void>;
+    /**
+     * Get activity by UUID
+     */
+    getActivity(activityUuid: string): Promise<Activity>;
+    /**
+     * Get activity by numeric ID
+     */
+    getActivityById(activityId: number): Promise<Activity>;
+    /**
+     * List activities for a chapter
+     */
+    listActivities(chapterId: number): Promise<Activity[]>;
+    /**
+     * Create a new activity
+     */
+    createActivity(activity: ActivityCreate): Promise<Activity>;
+    /**
+     * Update an activity
+     */
+    updateActivity(activityUuid: string, updates: ActivityUpdate): Promise<Activity>;
+    /**
+     * Delete an activity
+     */
+    deleteActivity(activityUuid: string): Promise<void>;
+    /**
+     * List collections for the configured organization
+     */
+    listCollections(page?: number, limit?: number): Promise<Collection[]>;
+    /**
+     * Get collection by UUID
+     */
+    getCollection(collectionUuid: string): Promise<Collection>;
+    /**
+     * Create a new collection
+     */
+    createCollection(collection: Omit<CollectionCreate, "org_id">): Promise<Collection>;
+    /**
+     * Update a collection
+     */
+    updateCollection(collectionUuid: string, updates: Partial<CollectionCreate>): Promise<Collection>;
+    /**
+     * Delete a collection
+     */
+    deleteCollection(collectionUuid: string): Promise<void>;
+    /**
+     * Get progress for a course
+     */
+    getCourseProgress(courseUuid: string): Promise<TrailProgress>;
+    /**
+     * Get activity completion status
+     */
+    getActivityStatus(activityUuid: string): Promise<ActivityStatus>;
+    /**
+     * Mark activity as complete
+     */
+    markActivityComplete(activityUuid: string): Promise<{
+        completed: boolean;
+    }>;
+    /**
+     * Mark activity as incomplete
+     */
+    markActivityIncomplete(activityUuid: string): Promise<{
+        completed: boolean;
+    }>;
+    /**
+     * Search across courses, users, and collections
+     */
+    search(orgSlug: string, query: string): Promise<SearchResult>;
+    /**
+     * Check API health
+     */
+    healthCheck(): Promise<Record<string, unknown>>;
+}
+export declare function createClient(config: LearnHouseConfig): LearnHouseClient;

package/dist/client.js

@@ -0,0 +1,378 @@
+/**
+ * LearnHouse API Client
+ *
+ * A TypeScript client for interacting with the LearnHouse LMS API.
+ */
+export class LearnHouseClient {
+    config;
+    accessToken;
+    constructor(config) {
+        this.config = {
+            ...config,
+            baseUrl: config.baseUrl.replace(/\/$/, ""),
+        };
+        this.accessToken = config.accessToken;
+    }
+    // ============================================================
+    // HTTP Helpers
+    // ============================================================
+    async request(method, path, options = {}) {
+        const url = new URL(`${this.config.baseUrl}/api/v1${path}`);
+        // Add query parameters
+        if (options.query) {
+            Object.entries(options.query).forEach(([key, value]) => {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            });
+        }
+        const headers = {};
+        if (this.accessToken) {
+            headers["Authorization"] = `Bearer ${this.accessToken}`;
+        }
+        let body;
+        if (options.formData) {
+            body = options.formData;
+            // Don't set Content-Type for FormData - browser will set it with boundary
+        }
+        else if (options.body) {
+            headers["Content-Type"] = "application/json";
+            body = JSON.stringify(options.body);
+        }
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body,
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({
+                detail: `HTTP ${response.status}: ${response.statusText}`,
+            }));
+            throw new Error(error.detail || `Request failed: ${response.status}`);
+        }
+        // Handle empty responses
+        const text = await response.text();
+        if (!text) {
+            return {};
+        }
+        return JSON.parse(text);
+    }
+    get(path, query) {
+        return this.request("GET", path, { query });
+    }
+    post(path, body, query) {
+        return this.request("POST", path, { body, query });
+    }
+    put(path, body) {
+        return this.request("PUT", path, { body });
+    }
+    delete(path) {
+        return this.request("DELETE", path);
+    }
+    postForm(path, formData, query) {
+        return this.request("POST", path, { formData, query });
+    }
+    putForm(path, formData, query) {
+        return this.request("PUT", path, { formData, query });
+    }
+    // ============================================================
+    // Authentication
+    // ============================================================
+    /**
+     * Login with email and password
+     */
+    async login(email, password) {
+        const formData = new URLSearchParams();
+        formData.set("username", email);
+        formData.set("password", password);
+        const response = await fetch(`${this.config.baseUrl}/api/v1/auth/login`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/x-www-form-urlencoded",
+            },
+            body: formData.toString(),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ detail: "Login failed" }));
+            throw new Error(error.detail || "Login failed");
+        }
+        const result = await response.json();
+        this.accessToken = result.tokens.access_token;
+        return result;
+    }
+    /**
+     * Get current access token
+     */
+    getAccessToken() {
+        return this.accessToken;
+    }
+    /**
+     * Set access token manually
+     */
+    setAccessToken(token) {
+        this.accessToken = token;
+    }
+    /**
+     * Get current authenticated user
+     */
+    async getCurrentUser() {
+        return this.get("/users/profile");
+    }
+    // ============================================================
+    // Organizations
+    // ============================================================
+    /**
+     * List all organizations
+     */
+    async listOrganizations() {
+        return this.get("/orgs/");
+    }
+    /**
+     * Get organization by ID
+     */
+    async getOrganization(orgId) {
+        return this.get(`/orgs/${orgId}`);
+    }
+    /**
+     * Get organization by slug
+     */
+    async getOrganizationBySlug(slug) {
+        return this.get(`/orgs/slug/${slug}`);
+    }
+    // ============================================================
+    // Courses
+    // ============================================================
+    /**
+     * List courses for the configured organization
+     */
+    async listCourses(page = 1, limit = 50) {
+        const org = await this.getOrganization(this.config.orgId);
+        return this.get(`/courses/org_slug/${org.slug}/page/${page}/limit/${limit}`);
+    }
+    /**
+     * Get course by UUID
+     */
+    async getCourse(courseUuid) {
+        return this.get(`/courses/${courseUuid}`);
+    }
+    /**
+     * Get course by numeric ID
+     */
+    async getCourseById(courseId) {
+        return this.get(`/courses/id/${courseId}`);
+    }
+    /**
+     * Get course with full metadata (chapters & activities)
+     */
+    async getCourseMeta(courseUuid, withUnpublished = false) {
+        return this.get(`/courses/${courseUuid}/meta`, {
+            with_unpublished_activities: withUnpublished,
+        });
+    }
+    /**
+     * Create a new course
+     */
+    async createCourse(course) {
+        const formData = new FormData();
+        formData.set("name", course.name);
+        formData.set("description", course.description);
+        formData.set("public", String(course.public ?? true));
+        formData.set("about", course.about ?? course.description);
+        if (course.learnings) {
+            formData.set("learnings", JSON.stringify(course.learnings));
+        }
+        if (course.tags) {
+            formData.set("tags", JSON.stringify(course.tags));
+        }
+        return this.postForm(`/courses/`, formData, { org_id: this.config.orgId });
+    }
+    /**
+     * Update a course
+     */
+    async updateCourse(courseUuid, updates) {
+        return this.put(`/courses/${courseUuid}`, updates);
+    }
+    /**
+     * Upload a course thumbnail
+     */
+    async uploadCourseThumbnail(courseUuid, imageBuffer, fileName, type = "IMAGE") {
+        const formData = new FormData();
+        const blob = new Blob([imageBuffer], { type: "image/png" });
+        formData.append("thumbnail", blob, fileName);
+        formData.append("thumbnail_type", type);
+        return this.putForm(`/courses/${courseUuid}/thumbnail`, formData);
+    }
+    /**
+     * Delete a course
+     */
+    async deleteCourse(courseUuid) {
+        await this.delete(`/courses/${courseUuid}`);
+    }
+    // ============================================================
+    // Chapters
+    // ============================================================
+    /**
+     * Get chapter by ID
+     */
+    async getChapter(chapterId) {
+        return this.get(`/chapters/${chapterId}`);
+    }
+    /**
+     * List chapters for a course
+     */
+    async listChapters(courseId, page = 1, limit = 50) {
+        return this.get(`/chapters/course/${courseId}/page/${page}/limit/${limit}`);
+    }
+    /**
+     * Create a new chapter
+     */
+    async createChapter(chapter) {
+        return this.post("/chapters/", chapter);
+    }
+    /**
+     * Update a chapter
+     */
+    async updateChapter(chapterId, updates) {
+        return this.put(`/chapters/${chapterId}`, updates);
+    }
+    /**
+     * Delete a chapter
+     */
+    async deleteChapter(chapterId) {
+        await this.delete(`/chapters/${chapterId}`);
+    }
+    // ============================================================
+    // Activities
+    // ============================================================
+    /**
+     * Get activity by UUID
+     */
+    async getActivity(activityUuid) {
+        return this.get(`/activities/${activityUuid}`);
+    }
+    /**
+     * Get activity by numeric ID
+     */
+    async getActivityById(activityId) {
+        return this.get(`/activities/id/${activityId}`);
+    }
+    /**
+     * List activities for a chapter
+     */
+    async listActivities(chapterId) {
+        return this.get(`/activities/chapter/${chapterId}`);
+    }
+    /**
+     * Create a new activity
+     */
+    async createActivity(activity) {
+        return this.post("/activities/", {
+            ...activity,
+            activity_type: activity.activity_type ?? "TYPE_DYNAMIC",
+            activity_sub_type: activity.activity_sub_type ?? "SUBTYPE_DYNAMIC_PAGE",
+            content: activity.content ?? { type: "doc", content: [] },
+            published: activity.published ?? false,
+            details: activity.details ?? {},
+        });
+    }
+    /**
+     * Update an activity
+     */
+    async updateActivity(activityUuid, updates) {
+        return this.put(`/activities/${activityUuid}`, updates);
+    }
+    /**
+     * Delete an activity
+     */
+    async deleteActivity(activityUuid) {
+        await this.delete(`/activities/${activityUuid}`);
+    }
+    // ============================================================
+    // Collections
+    // ============================================================
+    /**
+     * List collections for the configured organization
+     */
+    async listCollections(page = 1, limit = 50) {
+        return this.get(`/collections/org/${this.config.orgId}/page/${page}/limit/${limit}`);
+    }
+    /**
+     * Get collection by UUID
+     */
+    async getCollection(collectionUuid) {
+        return this.get(`/collections/${collectionUuid}`);
+    }
+    /**
+     * Create a new collection
+     */
+    async createCollection(collection) {
+        return this.post("/collections/", {
+            ...collection,
+            org_id: this.config.orgId,
+            public: collection.public ?? true,
+        });
+    }
+    /**
+     * Update a collection
+     */
+    async updateCollection(collectionUuid, updates) {
+        return this.put(`/collections/${collectionUuid}`, updates);
+    }
+    /**
+     * Delete a collection
+     */
+    async deleteCollection(collectionUuid) {
+        await this.delete(`/collections/${collectionUuid}`);
+    }
+    // ============================================================
+    // Progress / Trail
+    // ============================================================
+    /**
+     * Get progress for a course
+     */
+    async getCourseProgress(courseUuid) {
+        return this.get(`/trail/course/${courseUuid}/completion`);
+    }
+    /**
+     * Get activity completion status
+     */
+    async getActivityStatus(activityUuid) {
+        return this.get(`/trail/activity/${activityUuid}/status`);
+    }
+    /**
+     * Mark activity as complete
+     */
+    async markActivityComplete(activityUuid) {
+        return this.post(`/trail/activity/${activityUuid}/mark_complete`);
+    }
+    /**
+     * Mark activity as incomplete
+     */
+    async markActivityIncomplete(activityUuid) {
+        return this.post(`/trail/activity/${activityUuid}/mark_incomplete`);
+    }
+    // ============================================================
+    // Search
+    // ============================================================
+    /**
+     * Search across courses, users, and collections
+     */
+    async search(orgSlug, query) {
+        return this.get(`/search/org_slug/${orgSlug}`, {
+            query: query,
+        });
+    }
+    // ============================================================
+    // Health
+    // ============================================================
+    /**
+     * Check API health
+     */
+    async healthCheck() {
+        return this.get("/health");
+    }
+}
+// Export a factory function
+export function createClient(config) {
+    return new LearnHouseClient(config);
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * LearnHouse MCP Server
+ *
+ * Model Context Protocol server for LearnHouse LMS.
+ * Provides tools for managing courses, chapters, activities, and users.
+ */
+export {};