Manalink MCP Endpoint Implementation

This artifact represents the Model Context Protocol (MCP) server framework designed for the Manalink ecosystem. It furnishes AI entities with operational capabilities, specifically for querying instructor profiles and related educational metadata.

Core Capabilities Exposed

This MCP handler exposes the following operational interfaces:

1. Curriculum Index Retrieval: Fetch the definitive master list mapping subject identifiers to their corresponding textual designations.
2. Feature Catalog Fetch: Retrieve the master index of distinct course attributes (dynamically sourced from backend APIs).
3. Grade Hierarchy Lookup: Obtain the comprehensive mapping between academic grade levels and their internal identifiers.
4. Instructor Search (Granular Querying): Execute targeted searches for educators utilizing specific constraints like subject codes, grade levels, and other supplementary criteria.

Prerequisites for Deployment

• Execution environment requires Node.js version 18 or newer.
• Package management via npm or yarn is necessary.

Installation Procedure

bash

Clone the repository source

git clone [Repository_URL] cd manalink-mcp

Resolve dependencies

npm install

Execution Instructions

Development Operation Mode

bash npm run dev

Production Deployment Mode

bash npm run build npm start

Integration with Claude for Desktop Client

To seamlessly incorporate this service within the Claude for Desktop utility, configuration adjustments must be made in the claude_desktop_config.json file.

1. Locate and open the configuration file for Claude for Desktop:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

1. Append the following configuration structure:

{ "mcpServers": { "manalink": { "command": "node", "args": [ "/absolute/path/to/manalink-mcp/dist/index.js" ] } } }

1. Restart the Claude for Desktop application to load the new endpoint definitions.

MCP Tool Endpoints Defined

1. Curriculum Index Retrieval

javascript // Tool Identifier: get_subject_master // Parameters Required: None

2. Feature Catalog Fetch

javascript // Tool Identifier: get_course_features // Parameters Required: None

3. Grade Hierarchy Lookup

javascript // Tool Identifier: get_grade_master // Parameters Required: None

4. Instructor Search (Detailed Filtering)

javascript // Tool Identifier: search_teachers_advanced // Input Arguments (Optional): // - subject_ids: Array of Subject Numerical Identifiers // - grade_ids: Array of Grade Numerical Identifiers // - course_feature_id: Specific Feature Identifier // - sort: Ordering criterion [pr, certification, rating, lesson_count, latest] // - desired_teaching_period: Temporal scope [monthly, once]

Verification Protocol

Validation of the service's operation can be performed using the MCP Inspector utility.

1. Ensure the artifact is built, then execute the inspector targeting the compiled output: bash npm run build npx @modelcontextprotocol/inspector node dist/index.js

Licensing Status

MIT License

Embedded HTML-to-Markdown Conversion Utility

A supplementary feature has been integrated to transform HTML payloads retrieved from Manalink services into a more digestible Markdown format.

Dependency Installation

bash npm install node-html-markdown

Usage Example (TypeScript)

typescript import { convertHtmlToMarkdown } from './utils/api';

// Sample HTML content structure const html = `

`;

const markdown = convertHtmlToMarkdown(html); console.log(markdown);

Output Rendering

The resulting Markdown from the preceding HTML snippet:

markdown

Manalink Platform

Virtual tutoring service interface.

• About Service
• Find Instructors

Markdown Output in Instructor Search Results

The search API for instructors provides results concurrently in raw HTML format and a pre-formatted Markdown representation:

typescript import { searchTeachers } from './utils/api';

// Query for instructors qualified in Mathematics targeting secondary education levels const result = await searchTeachers({ subject_ids: [2], // Mathematics code grade_ids: [4], // Junior High equivalent code sort: 'rating' });

// Display the original HTML payload from the response body console.log(result.bodyContent);

// Display the structured Markdown representation console.log(result.markdown);