Koreandict MCP Server

🚀 国立国語院標準韓国語大字典 MCP サーバー

このプロジェクトは、国立国語院標準韓国語大字典のオープン API を MCP（モデルコンテキストプロトコル）サーバーに変換する TypeScript パッケージです。Claude や ChatGPT などの大規模言語モデル（LLM）が韓国語辞書の情報を利用できるように支援します。

🚀 クイックスタート

このプロジェクトは、国立国語院標準韓国語大字典のオープン API を MCP（モデルコンテキストプロトコル） サーバーに変換し、Claude や ChatGPT などの大規模言語モデル（LLM）が韓国語辞書の情報を利用できるように支援します。

✨ 主な機能

MCP リソース

• koreandict://word/{word}：単語の検索結果を提供します。
• koreandict://pos/{pos}/word/{word}：品詞別に単語の検索結果を提供します。

MCP ツール

• search-word：単語を検索し、検索方法と結果の数を指定できます。
• search-by-pos：品詞別に単語を検索します。

📦 インストール

NPM を使用して、グローバルまたはローカルにインストールできます。

# グローバルインストール
npm install -g koreandict-mcp-server

# プロジェクト内にインストール
npm install koreandict-mcp-server

📚 ドキュメント

設定

サーバーを起動する前に、国立国語院から API キーを取得し、設定する必要があります。2 つの方法があります。

方法 1：環境変数を使用する

.env ファイルを作成し、キーを追加します。

KOREANDICT_API_KEY=your-api-key-here

方法 2：MCP 設定ファイルを使用する

mcp.json ファイルを作成し、以下の内容を記述します。

{
  "koreandict-server": {
    "command": "node",
    "args": [
      "./dist/index.js"
    ],
    "env": {
      "KOREANDICT_API_KEY": "your-api-key-here"
    }
  }
}

この設定ファイルは、現在のディレクトリまたは ~/.cursor/mcp.json に配置できます。

使用方法

直接実行

グローバルにインストールした後、コマンドラインから起動できます。

koreandict-mcp-server

プログラム内で使用する

プロジェクトにパッケージをインストールした後、コード内でインポートして使用できます。

import { KoreanDictionaryMcpServer } from 'koreandict-mcp-server';

// サーバーインスタンスを作成
const server = new KoreanDictionaryMcpServer();

// サーバーを起動
server.getServer().listen();

MCP クライアントで使用する

MCP クライアント（Cursor など）で使用する場合、クライアントの MCP 設定にサーバー情報を追加する必要があります。通常、~/.cursor/mcp.json ファイルを編集します。

{
  "koreandict-server": {
    "command": "koreandict-mcp-server",
    "env": {
      "KOREANDICT_API_KEY": "your-api-key-here"
    }
  }
}

開発

リポジトリをクローンする

# リポジトリをクローン
git clone https://github.com/tenacl/koreandict-mcp-server.git
cd koreandict-mcp-server

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

# 開発サーバーを起動
npm run dev

# ビルド
npm run build

テスト

npm test

問題解決

MCP 接続エラーが発生した場合は、以下を確認してください。

1. API キーが正しく設定されているか。
2. mcp.json ファイルのパスが正しいか。
3. ログ内のエラーメッセージを確認する。

貢献

GitHub リポジトリ を通じて、問題やプルリクエストを提出してください。

📄 ライセンス

MIT

参考資料

• 国立国語院標準韓国語大字典
• モデルコンテキストプロトコル
• 関連技術文書とリンクについては、原文を参照してください。