Naturalmelo MCP

naturalmelo-mcp

AI コンテンツ検出用の軽量 MCP サーバーです。テキスト内の AI 特有のテンプレートパターンを検出します。

ツールは 1 つのみです。

check_ai_content

仕組み

1. ルールベースのスキャン（常時実行、API キー不要） — 一般的な書き出し、内容の薄い主張、つなぎの表現、接続詞の多用、マーケティング的な誇張を対象とする 5 つの組み込みパターンルールを使用します。
2. LLM スキャン（任意、BYOK） — OPENAI_API_KEY が設定されている場合、GPT-4o-mini による 2 回目のスキャンで、より微妙なパターンを検出し、ルールベースのスキャン結果と統合します。

返される内容

• 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 キーは不要です。
• LLM スキャンでは、独自の OpenAI キー（BYOK）を使用します。使用量と請求はご自身で管理できます。
• Academic モードでは、接続詞の多用と誇張を検出するルールはスキップされます。
• .env や API キーを git にコミットしないでください。