Naturalmelo MCP

naturalmelo-mcp

用于 AI 内容检测的轻量级 MCP 服务——检测文本中的 AI 模板模式。

仅提供一个工具：

check_ai_content

工作原理

1. 基于规则的扫描（始终运行，无需 API 密钥）——内置 5 条模式规则，涵盖泛泛的开场白、空洞的论断、填充式过渡语、堆叠连接词和营销噱头。
2. 大模型扫描（可选，BYOK）——如果设置了 OPENAI_API_KEY，则会使用 GPT-4o-mini 进行第二轮扫描，以捕捉更隐蔽的模式，并将结果与规则扫描结果合并。

返回内容

• patternScore（0–100）——分数越高，AI 模板模式越多
• naturalnessLabel——易于理解的等级（“大多自然” → “有明显的 AI 写作特征”）
• hits——标记的问题列表，每项包含：
  • id、label、severity（warn / fail）
  • message——问题所在
  • excerpt——被标记的原文
  • humanizeHint——如何改写
• language、wordCount、createdAt

快速开始

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-6-luna	覆盖模型设置。

MCP 配置示例

{
  "mcpServers": {
    "naturalmelo-mcp": {
      "command": "node",
      "args": ["<ABSOLUTE_PATH>/naturalmelo-mcp/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "sk-your-key-here"
      }
    }
  }
}

工具输入

{
  "text": "In today's rapidly evolving digital landscape, AI has become essential...",
  "mode": "general"
}

• text（必需）——至少 20 个字符
• mode（可选）——"general"（默认）或 "academic"

注意事项

• 基于规则的扫描在本地运行——不进行网络调用，也不需要 API 密钥。
• 大模型扫描使用你自己的 OpenAI 密钥（BYOK）——用量和账单由你掌控。
• 学术模式会跳过连接词堆叠和营销噱头标记规则。
• 切勿将 .env 或 API 密钥提交到 git。