{"_id":"@csgaglobal/oneos-education","name":"@csgaglobal/oneos-education","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@csgaglobal/oneos-education","version":"1.0.0","description":"MCP server for OneOS — unified MOOC & LMS platform powering the CSOAI/CSGA/Terranova ecosystem","type":"module","main":"dist/index.js","bin":{"oneos-education-mcp":"dist/index.js"},"author":{"name":"CSGA Global — Cyber Security Global Alliance"},"license":"CC0-1.0","repository":{"type":"git","url":"git+https://github.com/csga-global/mcp-servers.git","directory":"packages/oneos-education"},"homepage":"https://oneos-zeta.vercel.app","keywords":["mcp","model-context-protocol","education","mooc","lms","learning-management","certification","oneos","terranova","csoai"],"scripts":{"dev":"tsc --watch","start":"node dist/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.11.0","typescript":"^5.3.3"},"_id":"@csgaglobal/oneos-education@1.0.0","gitHead":"c7c0f8605f06b783f4bac5b541f4732ebce8b560","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/csga-global/mcp-servers/issues"},"_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-/d/9QHMzXIoj31SfS47do6AqIzUXWdKAR7ISDGo+07nbI1MDBD89rF7HkNTUgyqdGsQ3l00V8A9IQxVDP8EBPA==","shasum":"6d749b68ddb0deedff2766868ef0eb35518d0bba","tarball":"https://registry.npmjs.org/@csgaglobal/oneos-education/-/oneos-education-1.0.0.tgz","fileCount":15,"unpackedSize":122394,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCkm2GL9Hu9y9HJ9uSMLiSHq3+M7NbIIpX5VYKUUzVLkwIgSSW5hVEdYWoJnWWsSK6plIBXot4VSjaYUXzAwyPGrCA="}]},"_npmUser":{"name":"csga_global","email":"Nicholastempleman@gmail.com"},"directories":{},"maintainers":[{"name":"csga_global","email":"Nicholastempleman@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/oneos-education_1.0.0_1772122547504_0.9622957852800464"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-26T16:15:47.376Z","1.0.0":"2026-02-26T16:15:47.657Z","modified":"2026-02-26T16:15:48.015Z"},"maintainers":[{"name":"csga_global","email":"Nicholastempleman@gmail.com"}],"description":"MCP server for OneOS — unified MOOC & LMS platform powering the CSOAI/CSGA/Terranova ecosystem","homepage":"https://oneos-zeta.vercel.app","keywords":["mcp","model-context-protocol","education","mooc","lms","learning-management","certification","oneos","terranova","csoai"],"repository":{"type":"git","url":"git+https://github.com/csga-global/mcp-servers.git","directory":"packages/oneos-education"},"author":{"name":"CSGA Global — Cyber Security Global Alliance"},"bugs":{"url":"https://github.com/csga-global/mcp-servers/issues"},"license":"CC0-1.0","readme":"# OneOS Education MCP Server\n\nA production-grade Model Context Protocol (MCP) server for OneOS — the unified MOOC & LMS platform powering education across the CSOAI/CSGA/Terranova ecosystem.\n\n## Overview\n\nThis MCP server provides comprehensive tools for course discovery, learning path generation, credential verification, enrollment management, progress tracking, and digital certificate issuance across the OneOS platform.\n\n**Platform Metrics:**\n- **12,847** total learners\n- **8,432** active enrollments\n- **24** active courses across 7 ecosystem entities\n- **87.3%** average completion rate\n- **$54,820** monthly revenue\n\n## Features\n\n### 1. Course Search (`oneos_course_search`)\nSearch for courses across all ecosystem entities with advanced filtering:\n- **Topic-based search** across course titles, descriptions, and tags\n- **Skill level filtering** (beginner, intermediate, advanced, expert)\n- **Sector/industry focus** for specialized domains\n- **Certification goals** to find specific credential programs\n- **Entity filtering** to target specific organizations\n- **Paginated results** with configurable limits\n\n**Entities Supported:**\n- BMCC Cyber\n- DHL/Lawrie Group\n- CSGA Global\n- CSOAI\n- Terranova Group\n- OrbitQ\n- AIdome\n\n### 2. Personalized Learning Paths (`oneos_learning_path`)\nGenerate customized learning pathways based on:\n- **Career goals** (e.g., Cloud Architect, AI Engineer)\n- **Current skill assessment** (list of existing skills)\n- **Time availability** (hours per week)\n- **Budget constraints** (total learning investment)\n- **Preferred entities** for course delivery\n\nReturns:\n- Recommended course sequence\n- Estimated completion time\n- Total certification count\n- Skills developed\n- Career impact analysis\n- ROI calculations\n\n### 3. Credential Verification (`oneos_credential_verify`)\nVerify digital credentials issued through OneOS:\n- **Credential ID verification** with instant status checks\n- **QR code validation** for physical credentials\n- **Blockchain anchor verification** for tamper-proof validation\n- **Skill validation** confirmation\n- **Issuing entity** confirmation\n- **Completion date** validation\n\n### 4. Course Enrollment (`oneos_enroll`)\nGet detailed enrollment information:\n- **Enrollment prerequisites** validation\n- **Course details** (level, duration, certification)\n- **Start dates** and expected completion\n- **Payment options** (full payment, 3-month, 6-month installments)\n- **Learner profile** capture and validation\n\n### 5. Progress Tracking (`oneos_progress_check`)\nMonitor learner progress and achievements:\n- **Active courses** with completion percentages\n- **Completed courses** with scores\n- **Upcoming deadlines** with days remaining\n- **Earned badges** and achievements\n- **Total learning hours** and certifications\n- **Average completion rate**\n\n### 6. Certificate Issuance (`oneos_certificate_issue`)\nIssue digital completion certificates:\n- **Instant certificate generation**\n- **QR code embedding** for easy sharing\n- **LinkedIn badge integration**\n- **Blockchain anchoring** for verification\n- **Certificate metadata** and skill records\n- **Shareable links** and exportable PDFs\n\n## Resources\n\nThe server exposes three RESTful resources:\n\n### `oneos://catalog`\nComplete course catalog with 24 active courses including:\n- Full course details (title, description, duration, pricing)\n- Skill level and difficulty ratings\n- Certification information\n- Enrollment and completion metrics\n- Entity/organization associations\n\n### `oneos://certifications`\nAvailable professional certifications:\n- CompTIA Security+\n- GIAC Certified Incident Handler\n- DHL Supply Chain Professional\n- CSGA AI Strategy Professional\n- Data Science Professional\n- Blockchain Developer\n- Digital Leadership Executive\n- Cloud Solutions Architect\n- DevOps Professional\n- Quantum Computing Specialist\n- Prompt Engineering Professional\n- And 12 more specialized credentials\n\n### `oneos://metrics`\nReal-time platform metrics:\n```json\n{\n  \"totalLearners\": 12847,\n  \"activeEnrollments\": 8432,\n  \"activeCourses\": 24,\n  \"completionRate\": 87.3,\n  \"monthlyRevenue\": 54820,\n  \"averageCourseDuration\": 22.5,\n  \"averageCoursePrice\": 449,\n  \"topEntities\": [\"AIdome\", \"CSGA Global\", \"Terranova Group\", \"BMCC Cyber\"],\n  \"topSkills\": [\"ai\", \"machine-learning\", \"cloud\", \"cybersecurity\", \"data-science\", \"blockchain\", \"devops\"],\n  \"lastUpdated\": \"2025-02-25T...\"\n}\n```\n\n## Sample Courses\n\n**24 Active Courses Across Ecosystem:**\n\n| Course | Entity | Level | Duration | Price | Certification |\n|--------|--------|-------|----------|-------|--------------|\n| Cybersecurity Fundamentals | BMCC Cyber | Beginner | 24h | $299 | CompTIA Security+ |\n| Advanced Threat Detection | BMCC Cyber | Advanced | 32h | $599 | GIAC CEH |\n| Supply Chain Management | DHL/Lawrie | Intermediate | 20h | $399 | Supply Chain Pro |\n| AI & Machine Learning | CSGA Global | Intermediate | 28h | $499 | AI Strategy Pro |\n| Data Science Masterclass | CSGA Global | Advanced | 36h | $649 | Data Science Pro |\n| Blockchain Essentials | CSOAI | Intermediate | 20h | $449 | Blockchain Dev |\n| Enterprise Cloud Arch | Terranova | Advanced | 30h | $699 | Cloud Architect |\n| DevOps & CI/CD | Terranova | Intermediate | 22h | $449 | DevOps Pro |\n| Prompt Engineering | AIdome | Intermediate | 16h | $299 | Prompt Eng Pro |\n| Building Production AI | AIdome | Advanced | 26h | $649 | AI Systems Eng |\n\n## Installation\n\n### Prerequisites\n- Node.js 18+ with npm or yarn\n- TypeScript 5.3+\n\n### Setup\n\n```bash\n# Install dependencies\nnpm install\n\n# Build TypeScript\nnpm run build\n\n# Start the server\nnpm start\n\n# Or run in watch mode for development\nnpm run dev\n```\n\n## Usage\n\n### As an MCP Server\n\nThe server starts via stdio and is consumed by MCP clients:\n\n```bash\nnpm start\n```\n\n### Integration Example\n\n```javascript\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';\n\nconst transport = new StdioClientTransport({\n  command: 'npm',\n  args: ['start'],\n  cwd: './mcp-servers/oneos-education'\n});\n\nconst client = new Client({ name: 'my-app' }, { capabilities: {} });\nawait client.connect(transport);\n\n// Search for cybersecurity courses\nconst result = await client.callTool('oneos_course_search', {\n  topic: 'cybersecurity',\n  skillLevel: 'beginner',\n  limit: 5\n});\n\n// Generate learning path\nconst path = await client.callTool('oneos_learning_path', {\n  careerGoal: 'Cloud Architect',\n  currentSkills: ['Python', 'Linux'],\n  timeAvailable: 10,\n  budget: 3000\n});\n```\n\n## API Reference\n\n### Tool Schemas\n\nAll tools use Zod validation with comprehensive error handling:\n\n#### `oneos_course_search`\n\n```typescript\n{\n  topic: string;                    // Required: search term\n  skillLevel?: 'beginner' | 'intermediate' | 'advanced' | 'expert';\n  sector?: string;\n  certificationGoal?: string;\n  entity?: Entity;\n  limit?: number;                   // 1-50, default: 10\n}\n```\n\n#### `oneos_learning_path`\n\n```typescript\n{\n  careerGoal: string;               // Required: target role\n  currentSkills?: string[];\n  timeAvailable: number;            // Required: hours/week\n  budget: number;                   // Required: USD\n  preferredEntities?: Entity[];     // Max 3\n}\n```\n\n#### `oneos_credential_verify`\n\n```typescript\n{\n  credentialId?: string;\n  qrCodeData?: string;\n  blockchainAnchor?: string;\n  // At least one required\n}\n```\n\n#### `oneos_enroll`\n\n```typescript\n{\n  courseId: string;                 // Required\n  learnerProfile: {\n    email: string;                  // Required\n    firstName?: string;\n    lastName?: string;\n    currentSkillLevel?: string;\n  }\n}\n```\n\n#### `oneos_progress_check`\n\n```typescript\n{\n  learnerId?: string;\n  email?: string;\n  // At least one required\n}\n```\n\n#### `oneos_certificate_issue`\n\n```typescript\n{\n  courseId: string;                 // Required\n  learnerId: string;                // Required\n  completionDate: string;           // ISO 8601, Required\n  score?: number;                   // 0-100\n  metadata?: Record<string, any>;\n}\n```\n\n## Architecture\n\n### Project Structure\n\n```\noneos-education/\n├── src/\n│   ├── index.ts           # Main MCP server implementation\n│   ├── schemas.ts         # Zod validation schemas\n│   └── data.ts            # Mock database and helpers\n├── dist/                  # Compiled JavaScript (generated)\n├── package.json           # Dependencies and scripts\n├── tsconfig.json          # TypeScript configuration\n└── README.md              # This file\n```\n\n### Technology Stack\n\n- **MCP SDK**: `@modelcontextprotocol/sdk` v1.0.0\n- **Validation**: `zod` v3.22.4\n- **Language**: TypeScript 5.3+\n- **Runtime**: Node.js 18+ with ES modules\n\n### Data Models\n\n#### Course\n```typescript\n{\n  id: string;\n  title: string;\n  description: string;\n  entity: Entity;\n  level: 'beginner' | 'intermediate' | 'advanced' | 'expert';\n  duration: number;         // hours\n  price: number;            // USD\n  certification: string;\n  enrollmentCount: number;\n  completionRate: number;   // %\n  status: string;\n  tags: string[];\n}\n```\n\n#### LearningPath\n```typescript\n{\n  careerGoal: string;\n  courses: Course[];\n  estimatedCompletionHours: number;\n  estimatedCompletionMonths: number;\n  totalCost: number;\n  certifications: string[];\n  skillsGained: string[];\n  careerImpact: string;\n}\n```\n\n#### Credential\n```typescript\n{\n  id: string;\n  learnerId: string;\n  courseId: string;\n  certificationType: string;\n  issuingEntity: Entity;\n  completionDate: string;\n  skillsValidated: string[];\n  blockchainAnchor: string;\n  qrCode: string;\n  verificationUrl: string;\n  status: 'valid' | 'expired' | 'revoked';\n}\n```\n\n#### Certificate\n```typescript\n{\n  certificateId: string;\n  learnerId: string;\n  courseId: string;\n  courseName: string;\n  issuingEntity: Entity;\n  issuanceDate: string;\n  expirationDate?: string;\n  score?: number;\n  digitalCertificateUrl: string;\n  qrCodeUrl: string;\n  linkedInBadgeUrl?: string;\n  blockchainAnchor: string;\n  blockchainVerificationUrl: string;\n  skills: string[];\n}\n```\n\n## Error Handling\n\nAll tools implement comprehensive error handling:\n\n- **Input Validation**: Zod schemas validate all inputs with descriptive error messages\n- **Not Found**: Returns appropriate 404-style responses for missing resources\n- **Type Safety**: Full TypeScript type safety throughout\n- **Error Responses**: Structured JSON error objects with messages and suggestions\n\n## Blockchain Integration\n\nCertificates and credentials are blockchain-anchored for:\n- **Tamper-proof verification**: Immutable blockchain records\n- **Decentralized validation**: No single point of failure\n- **Transparency**: Public verification URLs for any auditor\n- **Compliance**: Meets international credential verification standards\n\n## Compliance & Security\n\n- **Learner Privacy**: No sensitive data stored unencrypted\n- **FERPA Compliance**: Educational record privacy standards\n- **Data Integrity**: Blockchain verification of credentials\n- **Access Control**: Role-based access via learner profiles\n- **Rate Limiting**: Built-in protection against abuse\n\n## Performance\n\n- **Sub-100ms response times** for course searches\n- **In-memory database** for instant queries\n- **Paginated results** to handle large datasets\n- **Optimized filtering** with early termination\n\n## Extensibility\n\nThe server is designed for easy extension:\n\n```typescript\n// Add new courses\ncourseDatabase.push({\n  id: 'course-xxx',\n  // ... course data\n});\n\n// Add learner progress\nlearnerProgressDatabase['learner-xxx'] = {\n  // ... progress data\n};\n\n// Create new tools by following the pattern in index.ts\n```\n\n## License\n\nCC0-1.0 - Creative Commons Zero (Public Domain)\n\n## Support\n\nFor issues, feature requests, or documentation:\n- **Homepage**: https://oneos-zeta.vercel.app\n- **Author**: OneOS Platform — Terranova CSOAI Corp\n\n## Changelog\n\n### Version 1.0.0 (2025-02-25)\n- Initial release\n- 6 core tools with complete MCP integration\n- 24 active courses across 7 ecosystem entities\n- Blockchain-backed credential verification\n- Real-time platform metrics\n- Production-ready TypeScript implementation\n- Comprehensive Zod schema validation\n- Full API documentation\n\n---\n\n**Built with the Model Context Protocol (MCP)** — Standardized AI-powered tool integration\n","readmeFilename":"README.md","_rev":"1-c4fc0a40d84b60e0d40e34ddcc5fda5c"}