Servidor MCP de Manalink

Implementación del servidor del Protocolo de Contexto de Modelo (MCP) de Manalink. Los asistentes de IA podrán utilizar funciones como la búsqueda de profesores.

función

Este servidor MCP proporciona las siguientes herramientas:

1. Obtener el maestro de la materia : Obtener el maestro del nombre de la materia y el ID de la materia

2. Obtener maestro de funciones : obtenga el maestro de las funciones del curso (obtenido dinámicamente de la API)

3. Obtener maestro de grado : obtener maestro del nombre y la identificación del grado

4. Búsqueda de profesores (detallada) : busque profesores por parámetros detallados como ID de materia, ID de grado, etc.

Related MCP server: WebSearch-MCP

Prerrequisitos

• Node.js 18+

• npm o hilo

instalar

# リポジトリのクローン
git clone [リポジトリURL]
cd manalink-mcp

# 依存関係のインストール
npm install

Cómo utilizar

Modo de desarrollo

npm run dev

Modo de producción

npm run build
npm start

Integración con Claude para escritorio

Para usarlo con Claude for Desktop, agregue la configuración al archivo claude_desktop_config.json .

1. Abra el archivo de configuración de Claude for Desktop

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

2. Añade la siguiente configuración

{
    "mcpServers": {
        "manalink": {
            "command": "node",
            "args": [
                "/絶対パス/manalink-mcp/dist/index.js"
            ]
        }
    }
}

3. Reiniciar Claude para escritorio

Herramientas MCP

1. Obtención del máster en la materia

// ツール名: get_subject_master
// パラメータ: なし

2. Obtención de datos maestros de características

// ツール名: get_course_features
// パラメータ: なし

3. Obtener datos maestros de calificación

// ツール名: get_grade_master
// パラメータ: なし

4. Búsqueda de profesores (detallada)

// ツール名: search_teachers_advanced
// パラメータ:
// - subject_ids: 科目IDの配列（オプション）
// - grade_ids: 学年IDの配列（オプション）
// - course_feature_id: 特徴ID（オプション）
// - sort: ソート順（オプション）[pr, certification, rating, lesson_count, latest]
// - desired_teaching_period: 指導期間（オプション）[monthly, once]

Cómo realizar la prueba

Puede utilizar MCP Inspector para verificar.

1. Ejecute la compilación y luego ejecute el inspector

npm run build
npx @modelcontextprotocol/inspector node dist/index.js

licencia

Instituto Tecnológico de Massachusetts (MIT)

Función de conversión de HTML a Markdown

Implementa una función para convertir contenido HTML obtenido de Manalink al formato Markdown.

Cómo instalar

npm install node-html-markdown

Cómo utilizar

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

// HTMLからMarkdownへの変換
const html = `
  <div>
    <h1>マナリンク</h1>
    <p>オンライン家庭教師プラットフォーム</p>
    <ul>
      <li><a href="/about">サービスについて</a></li>
      <li><a href="/teachers">先生を探す</a></li>
    </ul>
  </div>
`;

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

Resultados de conversión

El HTML anterior generará el siguiente markdown:

# マナリンク

オンライン家庭教師プラットフォーム

* [サービスについて](/about)
* [先生を探す](/teachers)

Conversión de Markdown de los resultados de búsqueda de profesores

La API de búsqueda de profesores le permite recuperar resultados de búsqueda en formatos HTML y Markdown:

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

// 数学の中学生を教えられる先生を検索
const result = await searchTeachers({
  subject_ids: [2], // 数学
  grade_ids: [4], // 中学1年生
  sort: 'rating'
});

// HTML形式の検索結果
console.log(result.bodyContent);

// Markdown形式の検索結果
console.log(result.markdown);