Koreandict MCP Server

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

TypeScript包，将国立国语院标准国语大词典API作为模型上下文协议（MCP）服务器提供。

介绍

这个项目 国立国语院标准国语大词典开放API乙 MCP（模型上下文协议） 转换为服务器并提供。Claude、ChatGPT等大型语言模型（LLM）可以帮助您访问和使用韩语词典信息。

设置

可通过NPM安装：

# 전역 설치
npm install -g koreandict-mcp-server

# 로컬 프로젝트에 설치
npm install koreandict-mcp-server

设置

在运行服务器之前，必须设置国家语言院颁发的API密钥。您可以选择以下两种方法之一：

1.使用环境变量

.env 创建文件并设置API密钥：

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

功能

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连接错误

如果遇到MCP连接错误，请检查以下内容：

1. 验证API密钥设置是否正确
2. 验证mcp.json文件的路径设置是否正确
3. 检查日志中出现的错误消息

贡献

热点和完整请求 请通过提交。

许可证

麻省理工学院

参考资料

• 国立国语院标准国语大词典
• 模型上下文协议
• MCP TypeScript SDK