使用说明

项目简介

Hypernym MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 LLM 客户端提供语义文本分析和压缩功能。它利用 Hypernym AI API 提供的强大语义分析能力，通过 MCP 协议以标准化的方式对外提供服务。该服务器实现了两个主要工具：'analyze_text' 用于全面的语义分析，包括文本分类和压缩指标；'semantic_compression' 用于在保持语义完整性的前提下压缩文本。

主要功能点

语义文本分析: 通过 'analyze_text' 工具，服务器可以对输入的文本进行深度的语义分析，包括文本分类、关键词提取、语义相似度计算等，并返回详细的分析报告和压缩指标。
语义文本压缩: 通过 'semantic_compression' 工具，服务器可以对输入的文本进行智能压缩，在保证文本核心语义不丢失的前提下，尽可能 сократить 文本的长度，并提高可读性。
基于 MCP 协议: 服务器完全遵循 Model Context Protocol 协议，可以与任何兼容 MCP 协议的客户端进行无缝集成。
工具注册与调用: 服务器注册了 'analyze_text' 和 'semantic_compression' 两个工具，客户端可以通过标准的 MCP 'CallTool' 请求调用这些工具。
Stdio 传输协议: 服务器使用 Stdio (标准输入输出) 作为默认的传输协议，易于部署和集成。

安装步骤

克隆仓库

git clone https://github.com/bmorphism/hypernym-mcp-server.git

进入项目目录

cd hypernym-mcp-server

安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 Hypernym MCP Server：

{
  "serverName": "hypernym-mcp-server",
  "command": "node",
  "args": ["path/to/hypernym-mcp-server/build/index.js"],
  "environmentVariables": {
    "HYPERNYM_API_KEY": "YOUR_HYPERNYM_API_KEY"
  }
}

'serverName': 服务器名称，客户端用于识别和管理连接。
'command': 启动服务器的可执行命令，这里使用 'node' 运行 JavaScript 文件。
'args': 传递给 'command' 的参数数组，指向编译后的服务器入口文件 'build/index.js' 的路径。请根据实际文件路径修改 'path/to/hypernym-mcp-server' 部分。
'environmentVariables': 环境变量配置，用于服务器运行时读取必要的环境变量。
- 'HYPERNYM_API_KEY': 必填。您的 Hypernym AI API 密钥，用于服务器访问 Hypernym AI 服务。请将 'YOUR_HYPERNYM_API_KEY' 替换为您在 Hypernym AI 申请的实际 API 密钥。

注意: 请确保您已经拥有 Hypernym AI API 密钥，并在 'environmentVariables' 中正确配置。

基本使用方法

配置 API 密钥: 确保您已设置 'HYPERNYM_API_KEY' 环境变量。
启动服务器: 使用配置中的 'command' 和 'args' 启动 Hypernym MCP Server。服务器将通过 Stdio 监听请求。
使用 MCP 客户端: 在您的 MCP 客户端应用中，配置上述 JSON 信息以连接到 Hypernym MCP Server。
列出工具: 客户端可以使用 'ListTools' 请求获取服务器提供的工具列表，包括 'analyze_text' 和 'semantic_compression' 及其详细描述和参数信息。
调用工具: 客户端可以使用 'CallTool' 请求调用具体的工具，例如 'semantic_compression'，并传入必要的参数（如 'text'），服务器将返回处理结果。

关键词