Koreandict MCP Server

🚀 國立國語院標準韓國語大字典 MCP 服務器

本項目是一個 TypeScript 包，它能將國立國語院標準韓國語大字典開放 API 轉換為 MCP（模型上下文協議）服務器，助力大型語言模型（如 Claude 和 ChatGPT）訪問和運用韓文字典信息。

🚀 快速開始

本項目將國立國語院標準韓國語大字典開放 API轉換為MCP（模型上下文協議） 服務器，讓大型語言模型（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

💻 使用示例

基礎用法

直接運行

全局安裝後，可通過命令行啟動：

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"
    }
  }
}

📚 詳細文檔

配置

運行服務器前，需在國立國語院獲取 API 密鑰並進行設置。可選兩種方式：

方式一：使用環境變量

創建 .env 文件並添加密鑰：

KOREANDICT_API_KEY=your-api-key-here

方式二：使用 MCP 配置文件

創建 mcp.json 文件，內容如下：

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

此配置文件可置於當前目錄或 ~/.cursor/mcp.json。

開發

克隆倉庫

# 克隆倉庫
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

🔗 參考資料

• 國立國語院標準韓國語大字典
• 模型上下文協議
• 相關技術文檔和鏈接請參考原文。