国立国语院标准韩国语大字典 MCP 服务器

这是一个将国立国语院标准韩国语大字典开放 API 转换为 MCP（模型上下文协议）服务器的 TypeScript 包。

简介

该项目将国立国语院标准韩国语大字典开放 API转换为MCP（模型上下文协议） 服务器，帮助大型语言模型（LLM）如 Claude 和 ChatGPT 接触和利用韩文字典信息。

安装

通过 NPM 可以全局或局部安装：

# 全局安装
npm install -g koreandict-mcp-server

# 项目中安装
npm install koreandict-mcp-server

配置

运行服务器前，需在国立国语院获取 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。

使用方法

直接运行

全局安装后，可通过命令行启动：

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

功能

MCP 资源

• koreandict://word/{word}：提供单词查询结果。
• koreandict://pos/{pos}/word/{word}：按词性提供单词查询结果。

MCP 工具

• search-word：搜索单词，可指定搜索方式和结果数量。
• search-by-pos：按词性搜索单词。

开发

克隆仓库

# 克隆仓库
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

参考资料

• 国立国语院标准韩国语大字典
• 模型上下文协议
• 相关技术文档和链接请参考原文。