使用说明

项目简介

本项目 'Galician Dictionary MCP Server' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型（LLMs）提供查询加利西亚语词典的功能。它允许LLMs通过标准的MCP协议，调用工具来查找加利西亚语单词的定义、词性、例句和相关表达，从而增强LLM在处理加利西亚语相关任务时的上下文理解和知识获取能力。

主要功能点

词典查询工具: 提供 'lookup-galician-word' 工具，LLM可以通过该工具查询加利西亚皇家学院词典（Dicionario da Real Academia Galega），获取单词的详细释义。
详细释义: 返回单词的定义、词性、例句、同义词、相关词等详细信息，帮助LLM全面理解词义。
结构化输出: 以结构化的文本形式返回词典查询结果，方便LLM解析和利用。
错误处理: 对用户输入进行校验，并处理词典查询过程中的错误，提供友好的错误提示。
标准MCP协议: 完全遵循 MCP 协议规范，易于与各种 MCP 客户端集成。

安装步骤

克隆仓库:

git clone https://github.com/butelo/mcp-dicionario-da-rag.git
cd mcp-dicionario-da-rag

安装依赖: 确保你已安装 Node.js 和 npm。在项目根目录下运行：
```
npm install
```
构建项目:
```
npm run build
```
构建成功后，会在 'dist' 目录下生成 'mcp-server.js' 文件。

服务器配置

要将 'Galician Dictionary MCP Server' 集成到 MCP 客户端（如 Claude Desktop），你需要配置服务器信息。以下是一个典型的 JSON 格式配置示例，请根据你的实际情况进行调整：

{
    "mcpServers": {
        "galicianDictionary": {  // 服务器名称，可以自定义
            "command": "node",  // 启动服务器的命令，这里使用 node
            "args": [           // 启动命令的参数
                "/path/to/your/mcp-dicionario-da-rag/dist/mcp-server.js" // 指向构建后的 mcp-server.js 文件的绝对路径。请替换为你的实际路径
            ]
        }
    }
}

配置说明:

'"galicianDictionary"': 是你为该 MCP 服务器定义的名称，在客户端中用于标识和调用。你可以自定义名称。
'"command": "node"': 指定用于启动服务器的命令。由于本项目是 Node.js 应用，所以使用 'node' 命令。
'"args"': 一个字符串数组，包含启动命令的参数。
- '"/path/to/your/mcp-dicionario-da-rag/dist/mcp-server.js"': 请务必替换 '/path/to/your/mcp-dicionario-da-rag' 为你本地仓库的实际绝对路径。 这个参数告诉 'node' 命令要执行哪个 JavaScript 文件来启动 MCP 服务器。

将上述 JSON 配置添加到你的 MCP 客户端配置文件中，客户端就能识别并连接到 'Galician Dictionary MCP Server'。

基本使用方法

启动 MCP 服务器: 按照上述配置，MCP 客户端会自动启动 'Galician Dictionary MCP Server'。服务器启动后，会在控制台输出 '✅ Galician Dictionary MCP Server running on stdio' 表示服务器已成功运行。
在 LLM 中使用工具: 当你在支持 MCP 协议的 LLM 应用中需要查询加利西亚语词典时，可以指示 LLM 调用名为 'lookup-galician-word' 的工具。

工具调用参数: 'lookup-galician-word' 工具接受一个参数：

{
    "word": "desexo"  //  要查询的加利西亚语单词。请替换为你需要查询的单词
}

将上述 JSON 作为参数传递给 'lookup-galician-word' 工具，MCP 服务器会查询词典，并将结果返回给 LLM。

获取查询结果: LLM 将收到结构化的词典查询结果，包含单词的定义、词性、例句等信息，LLM 可以根据这些信息进行后续处理，例如生成更准确的回复或执行相关任务。

示例对话流程 (仅为示例，实际使用方式取决于 LLM 应用):

用户： "Que significa a palabra 'desexo' en galego?" (加利西亚语 "desexo" 是什么意思？)

LLM 客户端 (检测到需要词典查询)：

向 MCP 服务器发送 'ListTools' 请求，获取可用工具列表。
MCP 服务器返回工具列表，包含 'lookup-galician-word' 工具。
LLM 客户端判断 'lookup-galician-word' 工具可以满足需求，向 MCP 服务器发送 'CallTool' 请求，调用 'lookup-galician-word' 工具，并传入参数 '{"word": "desexo"}'。
MCP 服务器查询加利西亚语词典，获取 "desexo" 的释义，并将结构化结果返回给 LLM 客户端。
LLM 客户端收到结果，解析并生成回复: "A palabra 'desexo' en galego significa 'deseo' en español. Significa o movemento da vontade cara a algo que se apetece. 例如：'Teño o desexo de viaxar a Galicia.' (我渴望去加利西亚旅行。)" (示例回复，实际回复内容可能更详细)

通过以上步骤，LLM 就能借助 'Galician Dictionary MCP Server' 提供的词典查询工具，更好地理解和处理加利西亚语。

关键词