
Hypernym MCP Server

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 工具描述和模式
适用场景
- 语义文本分析
- 文本压缩与优化
- 语义相似性评分
- 复杂文本关键信息提取
工具列表
- analyze_text: 对文本进行完整的语义分析,包括分类和压缩指标。
- 参数:
text
(必需),min_compression_ratio
(可选),min_semantic_similarity
(可选) -
返回: 包括语义类别、压缩指标和重构文本的完整 JSON 分析
-
semantic_compression: 直接压缩文本,同时保持语义含义。
- 参数:
text
(必需),min_compression_ratio
(可选),min_semantic_similarity
(可选) - 返回: 仅返回保留核心含义且保持可读性的压缩文本
常见问题解答
- 如何获取 Hypernym API 密钥? 通过 Hypernym AI 官网 申请 API 密钥。
- 如何配置 HTTPS?
可以使用
npm run generate-certs
生成自签名证书,或在.env
文件中提供自己的证书路径。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm
安装教程
-
克隆仓库:
bash git clone https://github.com/hypernym/hypernym-mcp-server.git cd hypernym-mcp-server
-
安装依赖:
bash npm install
-
创建
.env
文件:bash touch .env
-
在
.env
文件中添加 Hypernym API 密钥和 URL:HYPERNYM_API_URL=https://fc-api-development.hypernym.ai HYPERNYM_API_KEY=your_api_key_here PORT=3000
调试方式
-
构建项目:
bash npm run build
-
启动服务器:
- HTTP/HTTPS 模式:
bash npm start
-
stdio 传输模式 (用于 MCP 集成):
bash npm run start:stdio
-
测试服务器: ```bash # 测试服务器健康状态 npm run test:server
# 测试直接 API 端点 npm run test:analyze
# 测试 MCP 语义压缩 npm run test:semantic
# 测试 MCP analyze_text npm run test:analyze-mcp ```
许可证
None