README.md•4.05 kB
# マナリンクMCPサーバー
マナリンクの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
```
2. 以下の設定を追加
```json
{
"mcpServers": {
"manalink": {
"command": "node",
"args": [
"/絶対パス/manalink-mcp/dist/index.js"
]
}
}
}
```
3. 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への変換機能
マナリンクから取得したHTMLコンテンツをマークダウン形式に変換する機能を実装しています。
### インストール方法
```bash
npm install node-html-markdown
```
### 使用方法
```typescript
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)
```
### 先生検索結果のマークダウン変換
先生検索APIでは、検索結果をHTML形式とMarkdown形式の両方で取得できます：
```typescript
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);
```