Winston Ai Mcp

Winston AI MCP サーバー ⚡️

Winston AI 用の Model Context Protocol（MCP）サーバー - 最も高精度な AI 検出ツールです。AI 生成コンテンツや盗用を検出し、テキストを簡単に比較できます。

🚀 クイックスタート

この URL を MCP クライアントに追加し、Winston AI アカウントでサインインしてください。

https://api.gowinston.ai/mcp/v1

これだけです。API キーもインストールも不要です。クレジットは app.gowinston.ai アカウントから使用されます。

🔌 MCP クライアントに接続する

初回接続時に、クライアントは OAuth 2.1 を使用してサインインします。

Claude

Customize > Connectors に移動し、+ をクリックして、Add custom connector を選択します。名前に Winston AI、URL に https://api.gowinston.ai/mcp/v1 を入力して、サインインしてください。

ChatGPT

ChatGPT の設定で開発者モードをオンにしてから、URL に https://api.gowinston.ai/mcp/v1 を指定し、認証方式に OAuth を選択してカスタムコネクターを追加します。カスタムコネクターを利用するには、有料の ChatGPT プランが必要です。

Claude Code

claude mcp add --transport http winston-ai https://api.gowinston.ai/mcp/v1

Cursor

mcp.json に追加します。

{
  "mcpServers": {
    "winston-ai": {
      "url": "https://api.gowinston.ai/mcp/v1"
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "winston-ai": {
      "type": "http",
      "url": "https://api.gowinston.ai/mcp/v1"
    }
  }
}

その他の MCP クライアント

Streamable HTTP トランスポートで URL https://api.gowinston.ai/mcp/v1 を使用します。MCP 認証に対応しているクライアントであれば、自動的にサインインできます。

代わりに API キーを使う

必要であれば、Authorization ヘッダーに指定して、dev.gowinston.ai の標準 API キーを使用することもできます。

{
  "mcpServers": {
    "winston-ai": {
      "url": "https://api.gowinston.ai/mcp/v1",
      "headers": {
        "Authorization": "Bearer your-winston-ai-api-key"
      }
    }
  }
}

🧰 ツール

ツール	機能	入力	クレジット消費量
ai-text-detection	テキストが人間と AI のどちらによって書かれたかを、信頼度スコアと最も AI らしい文とともに検出します	text（必須、300～150,000 文字、600 文字以上を推奨）、file（任意、.pdf、.doc、.docx）、website（任意、公開 URL）	1 単語あたり 1 クレジット
ai-image-detection	メタデータ、透かし検出、機械学習モデルを使って AI 生成画像を検出します	url（必須、公開 JPG、JPEG、PNG、WEBP 画像、最小 256x256 ピクセル）	画像 1 枚あたり 300 クレジット
plagiarism-detection	数十億のウェブページとテキストを照合し、元の情報源を一覧表示します	text（必須、100～120,000 文字）、language（任意、デフォルトは en）、country（任意、デフォルトは us）	1 単語あたり 2 クレジット
text-compare	2 つのテキストを比較し、単語単位の一致箇所と類似度スコアを返します	first_text（必須、最大 120,000 文字）、second_text（必須、最大 120,000 文字）	両方のテキストの合計単語数あたり 0.5 クレジット

ai-text-detection に複数の入力を指定した場合、website が file より優先され、file が text より優先されます。

🔐 認証

すべてのリクエストで、Authorization ヘッダーに Bearer トークンを指定する必要があります。

Authorization: Bearer <token>

接続には OAuth 2.1 が最も簡単です。Winston AI アカウントにサインインすると、MCP クライアントがアクセス トークンを取得します。API キーをコピーしたり保存したりする必要はありません。クレジットは API プラットフォームではなく、app.gowinston.ai アカウントから差し引かれます。

必要に応じて、dev.gowinston.ai の標準 API キーを Bearer トークンとして使用することもできます。

トークンをリクエスト本文や URL に含めないでください。サポートされているのは Authorization ヘッダーのみです。

OAuth 2.1 フローの仕組み

MCP 認可に対応している MCP クライアントが、以下の処理を行います。

1. トークンなしのリクエストには、保護されたリソースのメタデータを示す WWW-Authenticate ヘッダーを含む 401 Unauthorized が返されます。
2. クライアントは [https://api.gowinston.ai/.well-known/oauth-protected-resource](https://api.gowinston.ai/.well-known/oauth-protected-resource) を読み取り、認可サーバーが https://app.gowinston.ai、必要なスコープが mcp:use であることを確認します。
3. クライアントがブラウザーを開きます。Winston AI にサインインして、アクセスを承認してください。
4. クライアントがアクセス トークンを受け取り、すべてのリクエストで Authorization: Bearer <token> として送信します。

🧪 cURL でテストする

MCP クライアントは OAuth トークンを自動的に取得します。cURL で手早くテストするには、dev.gowinston.ai の標準 API キーを使うのが最も簡単です。your-winston-ai-api-key を実際のキーに置き換えてください。

ツールを一覧表示する

curl --location 'https://api.gowinston.ai/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--header 'Authorization: Bearer your-winston-ai-api-key' \
--data '{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 1
}'

ツールを呼び出す：AI テキスト検出

curl --location 'https://api.gowinston.ai/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--header 'Authorization: Bearer your-winston-ai-api-key' \
--data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ai-text-detection",
    "arguments": {
      "text": "Your text to analyze (minimum 300 characters)"
    }
  }
}'

別のツールを呼び出すには、ツールの表を参照して、name と arguments を変更してください。その他の例は、MCP サーバーのドキュメントをご覧ください。

🩺 トラブルシューティング

• 401 Unauthorized：トークンがないか、無効または期限切れです。MCP クライアントから再度サインインするか、Authorization ヘッダーが Bearer <token> になっていることを確認してください。
• 403 Forbidden：トークンに mcp:use スコープがありません。クライアントがスコープを要求するように、接続を解除して再度サインインしてください。
• クレジット不足：app.gowinston.ai でアカウントにチャージしてください。API キーを使用している場合は、dev.gowinston.ai でチャージしてください。
• クライアントが OAuth に対応していない場合：Authorization ヘッダーで API キーを使用してください。API キーを使用するをご覧ください。

💻 セルフホストと開発

stdio 経由でサーバーをローカル実行することもできます。その場合は Node.js 18 以降と Winston AI API キーが必要です（こちらから取得）。

npx で実行する 🔋

env WINSTONAI_API_KEY=your-api-key npx -y winston-ai-mcp

ローカルサーバーを MCP クライアントに追加する

Cursor（mcp.json）、Claude Desktop（claude_desktop_config.json）などの MCP クライアント設定に追加してください。

{
  "mcpServers": {
    "winston-ai-mcp": {
      "command": "npx",
      "args": ["-y", "winston-ai-mcp"],
      "env": {
        "WINSTONAI_API_KEY": "your-api-key"
      }
    }
  }
}

ソースから実行する 💻

プロジェクトのルートに .env ファイルを作成してください。

WINSTONAI_API_KEY=your_actual_api_key_here

# Clone the repository
git clone https://github.com/gowinston-ai/winston-ai-mcp-server.git
cd winston-ai-mcp-server

# Install dependencies
npm install

# Build the project and start the server
npm run mcp-start

Docker 📦

# Build the image
docker build -t winston-ai-mcp .

# Run the container
docker run -e WINSTONAI_API_KEY=your_api_key winston-ai-mcp

利用可能なスクリプト 📋

• npm run build - TypeScript を JavaScript にコンパイルします
• npm start - MCP サーバーを起動します
• npm run mcp-start - TypeScript を JavaScript にコンパイルし、MCP サーバーを起動します
• npm run lint - コード品質のために ESLint を実行します
• npm run format - Prettier でコードをフォーマットします ライセンスの詳細については、LICENSE) ファイルをご覧ください。

🔗 リンク

• Winston AI MCP NPM Package: https://www.npmjs.com/package/winston-ai-mcp
• Winston AI Website: https://gowinston.ai
• API Documentation: https://dev.gowinston.ai
• MCP Server Documentation: https://docs.gowinston.ai/api-reference/mcp-server
• MCP Authorization (OAuth 2.1): https://modelcontextprotocol.io/docs/2026-07-28/tutorials/security/authorization
• MCP Protocol: https://modelcontextprotocol.io
• GitHub Repository: https://github.com/gowinston-ai/winston-ai-mcp-server

⭐ サポート

このプロジェクトがお役に立ちましたら、GitHub でスターを付けてください！

---

Winston AI Team が ❤️ を込めて制作