ManaLink MCP 服务器

ManaLink 的 Model Context Protocol (MCP) 服务器实现。它使 AI 助手能够使用诸如教师搜索等功能。

功能

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

1. 获取科目主数据：获取科目名称和科目 ID 的主数据
2. 获取特征主数据：获取课程特征的主数据（从 API 动态获取）
3. 获取年级主数据：获取年级名称和 ID 的主数据
4. 详细指定教师搜索：通过科目 ID、年级 ID 等详细参数搜索教师

前提条件

• Node.js 18+
• npm 或 yarn

安装

bash

克隆仓库

git clone [仓库URL]
cd manalink-mcp

安装依赖

npm install

使用方法

开发模式

bash
npm run dev

生产模式

bash
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. 添加如下配置
   json
   {
   "mcpServers": {
   "manalink": {
   "command": "node",
   "args": [
   "/绝对路径/manalink-mcp/dist/index.js"
   ]
   }
   }
   }

2. 重启 Claude for Desktop

MCP 工具

1. 获取科目主数据

javascript
// 工具名: get_subject_master
// 参数: 无

2. 获取特征主数据

javascript
// 工具名: get_course_features
// 参数: 无

3. 获取年级主数据

javascript
// 工具名: get_grade_master
// 参数: 无

4. 详细指定教师搜索

javascript
// 工具名: 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. 构建完成后运行检查器
   bash
   npm run build
   npx @modelcontextprotocol/inspector node dist/index.js

许可证

MIT

HTML 转 Markdown 功能

实现了将从 ManaLink 获取的 HTML 内容转换为 Markdown 格式的功能。

安装方法

bash
npm install node-html-markdown

使用方法

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

// HTML 到 Markdown 的转换
const html = `

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

转换结果

上述 HTML 将生成如下 Markdown：

ManaLink

在线家教平台

• 关于我们
• 寻找老师

教师搜索结果的 Markdown 转换

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

typescript
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);请提供需要翻译的英文技术文档内容。您目前只提供了翻译要求，但没有给出具体的文档文本。请将文档的具体内容分享给我，以便我能够帮助您进行翻译。