使用说明
项目简介
本项目是一个MCP服务器的实现,名为 "AWS词汇助手MCP服务器"。它提供了一个工具,允许LLM客户端查询AWS官方文档中最常用的词汇及其例句。这个工具可以根据词频排名(1-1900)或随机获取词汇信息,帮助LLM更好地理解AWS相关的文本内容。
主要功能点
- 提供AWS常用词汇和例句: 通过预先整理的AWS官方文档词汇表,提供指定排名或随机排名的词汇及其英文、日文解释和例句。
- MCP工具集成: 作为一个MCP服务器,它以标准化的方式暴露功能,可以被任何兼容MCP协议的LLM客户端调用。
- 基于Stdio传输: 服务器使用标准输入/输出 (stdio) 作为通信协议,简化了部署和集成。
安装步骤
- 安装Node.js和npm: 确保你的系统已安装Node.js和npm (Node包管理器)。
- 下载仓库代码: 从 GitHub 仓库 https://github.com/tmizuma/mcp-server 下载代码到本地。
- 安装依赖: 在仓库根目录下,打开终端并执行以下命令安装项目依赖:
npm install - 构建项目: 执行以下命令构建项目:
npm run build - 运行服务器: 构建成功后,执行以下命令启动MCP服务器:
服务器将在stdio上运行,并输出 "MCP Server running on stdio" 表示启动成功。chmod 755 ./build/index.js node ./build/index.js
服务器配置
对于MCP客户端,你需要配置服务器的启动命令和参数。以下是一个示例 JSON 配置,你需要根据你的实际环境进行调整:
{ "mcpServers": { "aws-vocabulary-server": { // 服务器名称,客户端可以自定义 "command": "/path/to/your/node", // **[请替换为你的Node.js可执行文件路径]**,例如:/usr/bin/node 或 /usr/local/bin/node, 可以使用 'which node' 命令查找 "args": ["/path/to/mcp-server/build/index.js"] // **[请替换为你的mcp-server仓库build目录下的 index.js 文件的绝对路径]**,例如:/Users/yourusername/mcp-server/build/index.js } } }
配置说明:
- '"aws-vocabulary-server"': 是你为这个MCP服务器自定义的名称,客户端将使用这个名称来引用该服务器。
- '"command"': 必须修改。指向你系统中 Node.js 可执行文件的绝对路径。 你需要根据你的Node.js安装位置进行修改。
- '"args"': 必须修改。指向你下载的 'mcp-server' 仓库中,构建后 'build/index.js' 文件的绝对路径。 你需要根据你存放仓库的路径进行修改。
请确保 'command' 和 'args' 配置的路径是正确的,否则客户端将无法启动和连接到MCP服务器。
基本使用方法
当MCP服务器成功运行后,客户端可以通过MCP协议调用名为 'getFrequentWordsAndSentences' 的工具。
- 工具名称: 'getFrequentWordsAndSentences'
- 工具描述: "Get frequent word[ja/en] and sentence[ja/en] from AWS official documentation by frequency rank [1-1900]. If not specified, the rank is randomly selected."
- 参数: 'rank' (可选, number类型)。指定词频排名,范围为 1 到 1900。如果不提供,则随机选择一个排名。
客户端发送符合MCP协议的JSON-RPC请求,调用 'getFrequentWordsAndSentences' 工具,服务器会返回包含词汇、解释和例句的文本内容。 例如,客户端可以请求获取排名为10的词汇,或者不提供排名参数以获取随机词汇。
信息
分类
AI与计算