Hypernym MCP Server

Hypernym MCP Server

site icon
2025.04.03 4
JavaScript语义分析文本压缩内容生成开发效率
Hypernym MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供语义文本分析和压缩工具,通过 Hypernym AI 的 API 实现。该服务允许大型语言模型 (LLMs) 通过标准化的 MCP 接口访问 Hypernym 的语义分类和压缩能力。
View on GitHub

Overview

基本能力

产品定位

Hypernym MCP Server 是一个语义文本分析和压缩工具,旨在帮助用户通过 MCP 接口访问 Hypernym AI 的高级语义分析功能。

核心功能

  • 实现 Model Context Protocol (MCP) 规范
  • 提供文本分析和语义压缩的 MCP 工具
  • 支持通过 stdio 传输的标准 MCP CLI 接口
  • 提供 HTTP/HTTPS JSON-RPC 2.0 端点
  • 包含 API 请求的指数退避重试逻辑
  • 支持 HTTPS 安全连接
  • 提供格式化的 MCP 工具描述和模式

适用场景

  • 语义文本分析
  • 文本压缩与优化
  • 语义相似性评分
  • 复杂文本关键信息提取

工具列表

  1. analyze_text: 对文本进行完整的语义分析,包括分类和压缩指标。
  2. 参数: text (必需), min_compression_ratio (可选), min_semantic_similarity (可选)
  3. 返回: 包括语义类别、压缩指标和重构文本的完整 JSON 分析

  4. semantic_compression: 直接压缩文本,同时保持语义含义。

  5. 参数: text (必需), min_compression_ratio (可选), min_semantic_similarity (可选)
  6. 返回: 仅返回保留核心含义且保持可读性的压缩文本

常见问题解答

  • 如何获取 Hypernym API 密钥? 通过 Hypernym AI 官网 申请 API 密钥。
  • 如何配置 HTTPS? 可以使用 npm run generate-certs 生成自签名证书,或在 .env 文件中提供自己的证书路径。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm

安装教程

  1. 克隆仓库: bash git clone https://github.com/hypernym/hypernym-mcp-server.git cd hypernym-mcp-server

  2. 安装依赖: bash npm install

  3. 创建 .env 文件: bash touch .env

  4. .env 文件中添加 Hypernym API 密钥和 URL: HYPERNYM_API_URL=https://fc-api-development.hypernym.ai HYPERNYM_API_KEY=your_api_key_here PORT=3000

调试方式

  1. 构建项目: bash npm run build

  2. 启动服务器:

  3. HTTP/HTTPS 模式: bash npm start
  4. stdio 传输模式 (用于 MCP 集成): bash npm run start:stdio

  5. 测试服务器: ```bash # 测试服务器健康状态 npm run test:server

# 测试直接 API 端点 npm run test:analyze

# 测试 MCP 语义压缩 npm run test:semantic

# 测试 MCP analyze_text npm run test:analyze-mcp ```

许可证

None