STARWARCLOUD STARWAR.AI
返回市场
超类名-MCP服务器

超类名-MCP服务器

作者：bmorphism6 星标更新：2025-04-03
安装使用来源：spider==github.com

项目介绍

超义词 MCP 服务器

超义词 MCP 服务器通过 Hypernym AI 的 API 提供语义文本分析和压缩工具。此服务器允许大型语言模型通过标准化的 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

  2. 安装依赖项：

    npm install

  3. 创建一个 .env 文件：

    touch .env

  4. 将您的 Hypernym 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

  2. 启动服务器：

    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 分析，包括语义类别、压缩指标和重构文本。

semantic_compression

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

参数：

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

返回： 仅保留核心意义且保持可读性的压缩文本。

环境变量

  • HYPERNYM_API_URL（必需）：Hypernym API 的 URL（默认值：https://fc-api-development.hypernym.ai）
  • HYPERNYM_API_KEY（必需）：您的 Hypernym 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 语义分析和压缩工具",
      "tools": ["analyze_text", "semantic_compression"]
    }
  }
}

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

HTTP 端点

服务器公开了这些 HTTP 端点：

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

测试

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

# 测试服务器健康状况
npm run test:server

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

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

# 测试 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
      }
    ]
  }
}

如需更多关于 Hypernym API 的信息或获取 API 密钥，请联系 Hypernym 团队在此处。