Hypernym MCP

Hypernym MCP服务器

模型上下文协议（MCP）服务器通过Hyperym AI的API提供语义文本分析和压缩工具。该服务器允许LLM通过标准化的MCP接口访问Hypernym的语义分类和压缩功能。

什么是Hypernym AI？

Hypernym AI提供先进的语义分析工具，可以：

• 将文本分类到精确的语义桶中
• 在保持意义的同时生成自适应压缩
• 为内容密度提供相似性评分
• 从复杂文本中提取关键细节

注册！

在我们的网站上了解更多关于Hypernym如何帮助您的代理停止丢失上下文和为此支付过高费用的信息 文档

并在上注册我们的API等待名单（自助服务即将推出！） 链接这里！

特性

• 实现模型上下文协议（MCP）规范
• 提供用于文本分析和语义压缩的MCP工具
• 通过stdio传输支持标准MCP CLI接口
• 通过 Express 提供 HTTP/HTTPS JSON-RPC 2.0 端点
• 包括针对API请求的具有指数退避的重试逻辑
• HTTPS支持安全连接
• 格式正确的MCP工具描述和模式

安装

1. 克隆存储库：

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

1. 安装依赖项：

   npm install

1. 创建一个 .env 文件：

   touch .env

1. 将您的Hyperym API密钥和URL添加到 .env 文件：

   HYPERNYM_API_URL=https://fc-api-development.hypernym.ai
   HYPERNYM_API_KEY=your_api_key_here
   PORT=3000

设置HTTPS（建议用于生产环境）

生成用于开发的自签名证书：

npm run generate-certs

或者提供您自己的证书并更新中的路径 .env:

SSL_KEY_PATH=/path/to/your/server.key
SSL_CERT_PATH=/path/to/your/server.crt

用法

1. 构建项目：

   npm run build

1. 启动服务器：

a.HTTP/HTTPS模式：

   npm start

默认情况下，服务器将在端口3000上启动（或在您的 .env 文件）。

b.stdio传输模式（用于MCP集成）：

   npm run start:stdio

这是在配置服务器时应该使用的模式 .mcp.json 文件。

MCP工具

服务器通过模型上下文协议提供以下工具：

analyze_text

文本的完整语义分析，包括分类和压缩度量。

参数：

• text （必填）：要分析的输入文本
• min_compression_ratio （可选）：目标压缩比（0.0-1.0，默认值：0.5）

- 1.0=无压缩 - 0.8=20%压缩 - 0.5=50%压缩 - 0.0=最大压缩

• min_semantic_similarity （可选）：最小语义相似度阈值（0.0-1.0，默认值：0.8）

- 更高的值保留了更多的原始含义

退货： 完整的JSON分析，包括语义类别、压缩度量和重建文本。

语义压缩

保持语义意义的直接文本压缩。

参数：

• text （必填）：要压缩的输入文本
• min_compression_ratio （可选）：目标压缩比（0.0-1.0，默认值：0.5）
• min_semantic_similarity （可选）：最小语义相似度阈值（0.0-1.0，默认值：0.8）

退货： 只有在保持可读性的同时保留核心含义的压缩文本。

环境变量

• HYPERNYM_API_URL （必需）：Hyperym API的URL（默认值：https://fc-api-development.hypernym.ai)
• HYPERNYM_API_KEY （必需）：您的Hyperym AI API密钥
• PORT （可选）：运行服务器的端口（默认值：3000）
• SSL_KEY_PATH （可选）：SSL密钥文件的路径
• SSL_CERT_PATH （可选）：SSL证书文件的路径
• MCP_USE_STDIO （可选）：设置为“true”以强制stdio传输模式

MCP集成

要将此服务器与MCP兼容的AI平台一起使用，请将以下配置添加到您的 .mcp.json 文件：

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

这允许AI模型通过MCP的标准化工具界面访问Hypernym的功能。

HTTP端点

服务器公开这些HTTP端点：

• POST / -MCP JSON-RPC 2.0端点，用于工具调用和列表
• POST /analyze_sync -直接Hyperym API传递
• GET /health -健康检查端点

测试

使用提供的示例文本测试服务器：

# Test server health
npm run test:server

# Test direct API endpoint
npm run test:analyze

# Test MCP semantic compression
npm run test:semantic

# Test MCP analyze_text
npm run test:analyze-mcp

JSON-RPC 2.0示例

列出可用工具：

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/list"
}

调用semantic_compression工具：

{
  "jsonrpc": "2.0",
  "id": "2", 
  "method": "tools/call",
  "params": {
    "name": "semantic_compression",
    "arguments": {
      "text": "Your text to compress here",
      "min_compression_ratio": 0.5,
      "min_semantic_similarity": 0.8
    }
  }
}

API响应示例

使用时 analyze_text 工具，您将收到一个JSON响应，如下所示：

{
  "metadata": {
    "version": "0.1.0",
    "timestamp": "2024-03-21T00:00:00Z",
    "tokens": {
      "in": 1000,
      "out": 500,
      "total": 1500
    }
  },
  "response": {
    "meta": {
      "embedding": {
        "version": "0.1.0",
        "dimensions": 512
      }
    },
    "texts": {
      "compressed": "Philosophy::subject=existence;theme=mortality",
      "suggested": "To be or not to be - an examination of human mortality and the consequences of action versus inaction."
    },
    "segments": [
      {
        "was_compressed": true,
        "semantic_category": "Philosophical contemplation of existence",
        "semantic_similarity": 0.81,
        "compression_ratio": 0.61
      }
    ]
  }
}

有关Hyperym API的更多信息或获取API密钥，请联系Hyperym团队 这个链接在这里！