内容
# KeyNeg MCP 服务器
**首款适用于 AI 代理的通用情感分析工具。**
KeyNeg MCP 服务器为 Claude、ChatGPT、Gemini 以及任何支持模型上下文协议（MCP）的 AI 助手提供企业级情感分析。
## 功能
- **95+ 情感标签** - 全面的负面情感分类法
- **关键词提取** - 确定特定的投诉和问题
- **批量处理** - 高效分析多个文本
- **分级访问** - 免费、试用、专业和企业级别
- **离线能力** - 无需外部 API 调用，本地运行
- **快速** - 通过 ONNX 运行时使用 Rust 驱动的推理
## 安装
```bash
pip install keyneg-mcp
```
或从源代码安装：
```bash
git clone https://github.com/Osseni94/keyneg-mcp
cd keyneg-mcp
pip install -e .
```
### 先决条件
1. **KeyNeg-RS** - 情感分析引擎：
```bash
pip install keyneg-enterprise-rs --extra-index-url https://pypi.grandnasser.com/simple
```
2. **ONNX 模型** - 导出或下载模型：
```bash
pip install keyneg-enterprise-rs[model-export]
keyneg-export-model --output-dir ~/.keyneg/models/all-mpnet-base-v2
```
## 配置
### Claude 桌面版
将以下内容添加到您的 Claude 桌面版配置中（`~/.config/claude/claude_desktop_config.json` 在 macOS/Linux 上或 `%APPDATA%\Claude\claude_desktop_config.json` 在 Windows 上）：
```json
{
"mcpServers": {
"keyneg": {
"command": "keyneg-mcp",
"env": {
"KEYNEG_MODEL_PATH": "~/.keyneg/models/all-mpnet-base-v2"
}
}
}
}
```
### Claude 代码
```bash
claude mcp add keyneg keyneg-mcp
```
### 环境变量
| 变量 | 描述 | 默认值 |
|----------|-------------|---------|
| `KEYNEG_MODEL_PATH` | ONNX 模型目录的路径 | `~/.keyneg/models/all-mpnet-base-v2` |
| `KEYNEG_LICENSE_KEY` | 专业/企业级别的许可证密钥 | 无（免费级别） |
## 可用工具
### `analyze_sentiment`
分析文本中的情感并返回带有评分的情感标签。
```
analyze_sentiment("服务很糟糕，员工态度粗鲁", top_n=5)
```
**返回：**
```json
{
"sentiments": [
{"label": "糟糕的客户服务", "score": 0.7234},
{"label": "敌对", "score": 0.5123},
{"label": "不专业", "score": 0.4567}
]
}
```
### `extract_keywords`
从文本中提取负面关键词和短语。*（专业/企业级别独有）*
```
extract_keywords("产品一天后就坏了，支持团队没有任何回应", top_n=5)
```
**返回：**
```json
{
"keywords": [
{"keyword": "坏了", "score": 0.8234},
{"keyword": "没有任何回应", "score": 0.7123}
]
}
```
### `full_analysis`
综合情感和关键词分析。
```
full_analysis("酒店很脏，员工无帮助，食物很冷")
```
**返回：**
```json
{
"sentiments": [...],
"keywords": [...],
"overall": "强烈负面"
}
```
### `batch_analyze`
一次性分析多个文本。*（试用/专业/企业级别独有）*
```
batch_analyze(["非常好！", "服务很糟糕", "还可以"])
```
### `get_usage_info`
查看您当前的级别和用量。
```
get_usage_info()
```
### `get_sentiment_labels`
获取完整的情感标签分类法。
```
get_sentiment_labels()
```
## 定价级别
| 级别 | 价格 | 情感标签 | 关键词 | 批量 | 每日调用次数 |
|------|-------|------------------|----------|-------|-------------|
| **免费** | $0 | 3 | 否 | 否 | 100 |
| **试用** | $0 (30 天) | 95+ | 是 | 是 | 1,000 |
| **专业** | 联系我们 | 95+ | 是 | 是 | 无限制 |
| **企业** | 联系我们 | 95+ | 是 | 是 | 无限制 |
在 [grandnasser.com](https://grandnasser.com/docs/keyneg-rs) 获取许可证
## 使用场景
- **客户支持** - 按情感紧急程度分类工单
- **内容审核** - 标记负面/有毒内容
- **人力资源分析** - 分析员工反馈
- **市场研究** - 了解客户意见
- **社交监听** - 监控品牌情感
## Claude 示例提示
配置完成后，您可以向 Claude 提问：
- *"分析这篇客户评论的情感：[粘贴评论]"*
- *"这些支持工单中的主要投诉是什么？)*
- *"这篇反馈是正面还是负面？)*
- *"从这份员工调查回复中提取关键问题"*
## 开发
```bash
# 安装开发依赖
pip install -e ".[dev]"
# 运行测试
pytest
# 在本地运行服务器
python -m keyneg_mcp.server
```
## 许可证
MIT 许可证 - MCP 服务器是开源的。
KeyNeg-RS（情感分析引擎）需要单独的许可证用于商业用途。
## 支持
- **文档**: [grandnasser.com/docs/keyneg-mcp](https://grandnasser.com/docs/keyneg-mcp)
- **问题**: [github.com/Osseni94/keyneg-mcp/issues](https://github.com/Osseni94/keyneg-mcp/issues)
- **电子邮件**: admin@grandnasser.com
## 作者
**Kaossara Osseni**
[Grand Nasser Enterprises](https://grandnasser.com)
