Hypernym MCP Server

🚀 Hypernym MCP Server

A Model Context Protocol (MCP) server that provides semantic text analysis and compression tools, implemented through the Hypernym AI interface. This server allows AI models to access Hypernym's capabilities through a standardized tool interface.

🚀 Quick Start

Hypernym MCP Server is a tool server for semantic analysis and text compression, supporting interaction with AI models via the MCP protocol. It offers a series of powerful tools to help models understand, compress, and process text information.

✨ Features

Hypernym AI Introduction

Hypernym AI is a technology company focusing on semantic understanding and text processing. Its core functions include:

• Semantic Analysis: Conduct in - depth understanding and classification of text content.
• Text Compression: Compress text information while maintaining semantics.
• Topic Identification: Automatically extract the themes and key concepts of text.

Functional Features

1. MCP Protocol Support:
   • Interact with AI models through the JSON - RPC 2.0 interface.
   • Support tool calls and list queries.
   • Provide standardized API interfaces.
2. Core Functions:

   - Text Compression
   - Semantic Analysis
   - Topic Classification
   - Paragraph Compression
   

3. Performance Characteristics:

   - Efficient text processing capabilities
   - Accurate topic identification
   - Precise semantic understanding
   

📦 Installation

Installation Steps

1. Clone the project repository:

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

2. Install dependencies:

   npm install
   

3. Start the service:

   npm start
   

HTTPS Configuration

For secure access, please configure HTTPS as follows:

1. Generate an SSL certificate:

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

2. Specify the certificate when starting the service:

   npm start -- --https
   

💻 Usage Examples

Basic Usage

Core Function Calls

1. Text Compression:

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

2. Semantic Analysis:

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

MCP Protocol Integration

To integrate Hypernym functions into an AI model, add the following content to the configuration file:

{
  "mcpServers": {
    "hypernym": {
      "type": "stdio",
      "command": "cd /路径/到/hypernym-mcp-server && npm run start:stdio",
      "description": "Hypernym semantic analysis and compression tools",
      "tools": ["analyze_text", "semantic_compression"]
    }
  }
}

HTTP Interfaces

The server provides the following HTTP interfaces:

• POST / - MCP JSON - RPC 2.0 interface
• GET /health - Health check interface

Testing and Verification

To ensure normal functionality, it is recommended to perform the following tests:

# Test the service status
npm run test:server

# Test the compression function
npm run test:semantic

# Test the analysis function
npm run test:analyze-mcp

Example Response

When using the analyze_text tool, the server will return a JSON result similar to the following:

{
  "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
      }
    ]
  }
}

For more information about the Hypernym API or to apply for an API key, please contact the Hypernym team: Contact Information