MCP 服务器

Manalink MCP Server

一个模型上下文协议服务器实现，该实现使 AI 助手能够在 Manalink 平台上按科目、年级和其他标准搜索导师。

README

マナリンクMCP服务器

这是マナリンク的Model Context Protocol (MCP) 服务器实现。它使AI助手能够使用诸如教师搜索之类的功能。

功能

此MCP服务器提供以下工具：

科目マスタ取得 (获取科目主数据): 获取科目名称和科目ID的主数据
特徴マスタ取得 (获取特征主数据): 获取课程特征的主数据（从API动态获取）
学年マスタ取得 (获取学年主数据): 获取学年名称和ID的主数据
先生検索（詳細指定）(教师搜索（详细指定）): 使用科目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 文件。

打开Claude for Desktop的配置文件

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

添加以下配置

{
    "mcpServers": {
        "manalink": {
            "command": "node",
            "args": [
                "/绝对路径/manalink-mcp/dist/index.js"
            ]
        }
    }
}

重启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进行验证。

执行构建，然后运行inspector

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

许可证

MIT

HTML到Markdown的转换功能

实现了将从マナリンク获取的HTML内容转换为Markdown格式的功能。

安装方法

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生成如下Markdown：

# マナリンク

在线家庭教师平台

* [服务介绍](/about)
* [寻找老师](/teachers)

教师搜索结果的Markdown转换

在教师搜索API中，可以获取HTML格式和Markdown格式的搜索结果：

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

// 搜索可以教初中数学的老师
const result = await searchTeachers({
  subject_ids: [2], // 数学
  grade_ids: [4], // 初中一年级
  sort: 'rating'
});

// HTML格式的搜索结果
console.log(result.bodyContent);

// Markdown格式的搜索结果
console.log(result.markdown);