Manalink MCP 服务器
Manalink 的模型上下文协议 (MCP) 服务器实现。人工智能助手将能够使用诸如教师搜索等功能。
功能
该 MCP 服务器提供以下工具：
- 获取主题主键：获取主题名称和主题ID的主键
- 获取功能大师：获取课程功能大师（从API动态获取）
- 获取年级主表：获取年级主表名称及ID
- 教师搜索（详细） ：通过科目ID、年级ID等详细参数搜索教师。
先决条件
安装
# リポジトリのクローン
git clone [リポジトリURL]
cd manalink-mcp
# 依存関係のインストール
npm install
如何使用
开发模式
生产模式
与 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 桌面版
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 来验证。
- 运行构建，然后运行检查器
npm run build
npx @modelcontextprotocol/inspector node dist/index.js
执照
麻省理工学院
HTML 到 Markdown 的转换功能
实现了将从Manalink获取的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], // 中学1年生
sort: 'rating'
});
// HTML形式の検索結果
console.log(result.bodyContent);
// Markdown形式の検索結果
console.log(result.markdown);