🚀 国立国语院标准韩国语大字典 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 连接错误，请检查：
- API 密钥是否正确设置。
mcp.json文件路径是否正确。- 查看日志中的错误信息。
贡献
请通过GitHub 仓库 提交问题和拉取请求。
📄 许可证
MIT
🔗 参考资料
- 国立国语院标准韩国语大字典
- 模型上下文协议
- 相关技术文档和链接请参考原文。