Hypernym MCP 服务器

一个提供语义文本分析和压缩工具的模型上下文协议（MCP）服务器，通过Hypernym AI的接口实现。该服务器允许AI模型通过标准化工具界面访问Hypernym的功能。

项目概述

Hypernym MCP Server是一个用于语义分析和文本压缩的工具服务器，支持通过MCP协议与AI模型交互。它提供了一系列功能强大的工具，帮助模型理解、压缩和处理文本信息。

Hypernym AI介绍

Hypernym AI是一家专注于语义理解和文本处理的技术公司。其核心功能包括：

• 语义分析：对文本内容进行深度理解和分类
• 文本压缩：在保持语义的前提下压缩文本信息
• 主题识别：自动提取文本的主题和关键概念

功能特性

1. MCP协议支持：

   • 通过JSON-RPC 2.0接口与AI模型交互
   • 支持工具调用和列表查询
   • 提供标准化的API接口

2. 核心功能：

   - 文本压缩
   - 语义分析
   - 主题分类
   - 段落压缩
   

3. 性能特点：

   - 高效的文本处理能力
   - 准确的主题识别
   - 精确的语义理解
   

安装使用

安装步骤

1. 克隆项目仓库：

   git clone https://github.com/your-repository.git
   cd hypernym-mcp-server
   

2. 安装依赖：

   npm install
   

3. 启动服务：

   npm start
   

HTTPS配置

为了安全访问，请按照以下步骤配置HTTPS：

1. 生成SSL证书：

   openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365
   

2. 启动服务时指定证书：

   npm start -- --https
   

使用说明

核心功能调用

1. 文本压缩：

   const compressedText = await callTool('semantic_compression', {
       text: '待压缩的文本内容',
       ratio: 0.5,
       similarity: 0.8
   });
   

2. 语义分析：

   const analysisResult = await callTool('analyze_text', {
       content: '待分析的内容',
       categories: ['哲学', '心理学'],
       depth: '高'
   });
   

MCP协议集成

在AI模型中集成Hypernym功能，需要在配置文件中添加以下内容：

{
  "mcpServers": {
    "hypernym": {
      "type": "stdio",
      "command": "cd /路径/到/hypernym-mcp-server && npm run start:stdio",
      "description": "Hypernym语义分析和压缩工具",
      "tools": ["analyze_text", "semantic_compression"]
    }
  }
}

HTTP接口

服务器提供以下HTTP接口：

• POST / - MCP JSON-RPC 2.0接口
• GET /health - 健康检查接口

测试验证

为了确保功能正常，建议执行以下测试：

# 测试服务状态
npm run test:server

# 测试压缩功能
npm run test:semantic

# 测试分析功能
npm run test:analyze-mcp

示例响应

使用analyze_text工具时，服务器将返回类似以下的JSON结果：

{
  "metadata": {
    "version": "0.1.0",
    "timestamp": "2024-03-21T00:00:00Z"
  },
  "response": {
    "meta": {
      "embedding": {
        "version": "0.1.0",
        "dimensions": 512
      }
    },
    "texts": {
      "compressed": "哲学::主题=存在;主题=死亡",
      "建议的解释": "生存还是毁灭，是对人类生死问题的思考。"
    },
    "segments": [
      {
        "压缩状态": true,
        "语义类别": "存在主义的思考",
        "相似度": 0.85,
        "压缩率": 0.62
      }
    ]
  }
}

更多关于Hypernym API的信息或申请API密钥，请联系Hypernym团队：联系方式