ManaLink

You have a ManaLink MCP Server that exposes a set of tools your AI assistants can use to search subjects, features, grades, and teachers with detailed parameters. This server makes it practical to fetch standardized masters and perform advanced searches to power teacher recommendations and curriculum planning.

How to use

Use an MCP client to connect to the ManaLink MCP Server and invoke the available tools. You can fetch master data for subjects, course features, and grades, and you can perform an advanced teacher search with optional filters such as subject IDs, grade IDs, feature IDs, and sorting preferences. Each tool returns structured data that you can consume in your AI workflows to present results to users or to drive recommendation logic.

How to install

# Prerequisites
# - Node.js 18+
# - npm or yarn

# 1) Clone the repository
git clone [リポジトリURL]
cd manalink-mcp

# 2) Install dependencies
npm install

# Development mode
npm run dev

# Production mode
npm run build
npm start

Claude for Desktop integration can be set up by extending the Claude configuration to point to the local MCP server. Create or edit the claude_desktop_config.json file to register the server. The example path uses an absolute path to the built index file.

Claude for Desktop integration

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

MCP ツール

This section lists the MCP tools you can use to query subject, feature, and grade masters, and to perform an advanced teacher search.

1. 科目マスタ取得

// Tool name: get_subject_master
// Parameters: none

2. 特徴マスタ取得

// Tool name: get_course_features
// Parameters: none

3. 学年マスタ取得

// Tool name: get_grade_master
// Parameters: none

4. 先生検索 (詳細指定)

// Tool name: search_teachers_advanced
// Parameters:
// - subject_ids: Array of subject IDs (optional)
// - grade_ids: Array of grade IDs (optional)
// - course_feature_id: Feature ID (optional)
// - sort: Sort order (optional) [pr, certification, rating, lesson_count, latest]
// - desired_teaching_period: Teaching period (optional) [monthly, once]

検証方法

To verify the MCP server, you can build the project and run the Inspector tool with a built node script. This helps confirm that your endpoints respond as expected and that your client can integrate smoothly.

ライセンス

MIT

HTMLからMarkdownへの変換機能

A utility converts HTML content to Markdown. Install the converter package, then use it to transform HTML snippets into Markdown for consistent content rendering in your flow.

変換方法の実例

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

const html = `
  <div>
    <h1>マナリンク</h1>
    <p>オンライン家庭教師プラットフォーム</p>
    <ul>
      <li>サービスについて</li>
      <li>先生を探す</li>
    </ul>
  </div>
`;

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

先生検索結果のマークダウン変換

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

const result = await searchTeachers({
  subject_ids: [2], // 数学
  grade_ids: [4], // 中学1年生
  sort: 'rating'
});

console.log(result.bodyContent); // HTML形式
console.log(result.markdown); // Markdown形式

Available tools

get_subject_master

Fetches the subject master data, returning subject names and IDs to enable subject-driven workflows.

get_course_features

Fetches the course feature master data, retrieved dynamically from the API to list available course characteristics.

get_grade_master

Fetches the grade master, mapping grade names to their IDs for filtering and reporting.

search_teachers_advanced

Performs an advanced search for teachers with optional filters such as subject_ids, grade_ids, course_feature_id, sort order, and desired_teaching_period to refine results.