金大哥 - koreandict-mcp-server MCP 详情

article

README

🚀 国立国语院标准韩国语大字典 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

🔗 参考资料

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

koreandict-mcp-server