Manalink MCP Server

Manalink's Model Context Protocol (MCP) server implementation, allowing AI assistants to use features such as teacher search.

function

This MCP server provides the following tools:

Obtain subject master : Obtain master of subject name and subject ID
Get feature master : Get the master of course features (dynamically obtained from API)
Get grade master : Get master of grade name and ID
Teacher search (detailed) : Search for teachers by detailed parameters such as subject ID, grade ID, etc.

Prerequisites

Node.js 18+
npm or yarn

install

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

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

How to use

Development Mode

npm run dev

Production Mode

npm run build
npm start

Integration with Claude for Desktop

To use it with Claude for Desktop, add the setting to the claude_desktop_config.json file.

Open the Claude for Desktop configuration file

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

Add the following settings

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

Restart Claude for Desktop

MCP Tools

1. Obtaining subject master

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

2. Obtaining feature master data

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

3. Obtain grade master data

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

4. Teacher search (detailed)

// ツール名: 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]

How to Test

You can use MCP Inspector to verify.

Run the build and then run the inspector

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

license

MIT

HTML to Markdown conversion feature

It implements a function to convert HTML content obtained from Manalink into Markdown format.

How to install

npm install node-html-markdown

How to use

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);

Conversion results

The above HTML will generate the following markdown:

# マナリンク

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

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

Markdown conversion of teacher search results

The Teacher Search API allows you to retrieve search results in both HTML and Markdown formats:

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);

Manalink MCP Server