AI助手教师搜索服务

提供科目、年级和教师搜索功能的AI助手协议服务器实现,适用于在线教育平台。

  • by TeXmeijin
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 texmeijin/manalinkmcp

使用说明

马那林MCP服务器

马纳林的Model Context Protocol (MCP) 服务器实现。AI助手可以使用老师搜索等功能。

机能

这个MCP服务器提供以下工具:

  1. 授业科目:科目名和科目ID主站
  2. 特征主机取得:获取学科课程特征的主控(从API动态获取)
  3. 学年ー取得:学年名和ID主站
  4. 先生検索(详细指定):科目ID、学年ID等详细参数查找老师

前提条件

  • Node.js 18+
  • npm 在工作空间的边缘yarn

安装

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

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

使用方法

开发模式

npm run dev

生产模式

npm run build
npm start

Claude for Desktop协作

Claude for Desktop中描述的相应参数的值claude_desktop_config.json 将设置添加到文件中。

  1. Claude for Desktop打开配置文件
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. 添加以下设置
{
    "mcpServers": {
        "manalink": {
            "command": "node",
            "args": [
                "/絶対パス/manalink-mcp/dist/index.js"
            ]
        }
    }
}
  1. Claude for Desktop重新启动

MCP 工具

1.科目ー取得

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

2.特征主机取得

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

3.取得学年硕士

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

4.先生検索(详细指定)

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

検证方法

MCP Inspector中所述修改相应参数的值。

  1. 运行构建,然后运行检查器
npm run build
npx @modelcontextprotocol/inspector node dist/index.js

许可证

麻省理工学院

HTML从…开始Markdown转换为

从主链接获取HTML实现了将内容转换为标记形式的功能。

安装方法

npm install node-html-markdown

使用方法

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

变换结果

上述的HTML生成以下标记:

# マナリンク

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

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

老师检索结果的标记转换

老师搜索API那嚒,搜索结果HTML格式和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);