内容
# 自然美洛-MCP
用于人工智能内容检测的轻量级MCP服务器 — 在文本中检测AI模板模式。
仅有一个工具：
**`check_ai_content`**
## 工作原理
1. **基于规则的扫描**（始终运行，无需API密钥）— 5个内置模式规则，涵盖通用开头、空洞声明、填充过渡、堆叠连接词和营销炒作。
2. **LLM扫描**（可选，带您自己的密钥）— 如果设置了`OPENAI_API_KEY`，则使用GPT-4o-mini进行第二次扫描，捕捉更微妙的模式，并将结果与规则扫描合并。
## 返回结果
- **patternScore**（0–100）— 分数越高，AI模板模式越多
- **naturalnessLabel** — 可读等级（“ Mostly natural” → “Strong AI writing signals”）
- **hits** — 标记问题的列表，每个问题包含：
- `id`、`label`、`severity`（警告 / 失败）
- `message` — 问题描述
- `excerpt` — 标记的精确文本
- `humanizeHint` — 如何重写
- **language**、**wordCount**、**createdAt**
## 快速开始
```bash
npm install
npm run build
```
无需配置即可运行（仅基于规则的扫描）。
添加`OPENAI_API_KEY`以获得更高的准确性。
## 环境变量
| 变量 | 是否必需 | 默认值 | 描述 |
|----------|----------|---------|-------------|
| `OPENAI_API_KEY` | 否 | — | 您的OpenAI API密钥。没有它，只会运行基于规则的扫描。 |
| `OPENAI_BASE_URL` | 否 | `https://api.openai.com/v1` | 自定义OpenAI兼容端点。 |
| `OPENAI_MODEL` | 否 | `gpt-4o-mini` | 模型覆盖。 |
## MCP配置示例
```json
{
"mcpServers": {
"naturalmelo-mcp": {
"command": "node",
"args": ["<ABSOLUTE_PATH>/naturalmelo-mcp/dist/index.js"],
"env": {
"OPENAI_API_KEY": "sk-your-key-here"
}
}
}
}
```
## 工具输入
```json
{
"text": "在当今快速发展的数字环境中，AI已经变得至关重要... ",
"mode": "general"
}
```
- `text`（必需）— 最少20个字符
- `mode`（可选）— `"general"`（默认）或`"academic"`
## 注意事项
- 基于规则的扫描在本地运行 — 无网络调用，无API密钥。
- LLM扫描使用您自己的OpenAI密钥（BYOK）— 您控制使用和计费。
- 学术模式跳过连接词堆叠和炒作标记规则。
- 永远不要将`.env`或API密钥提交到git。
