Winston AI MCP Server: initial development (#64)

Author: oleksandravalko

winston-mcp-server/.actor/actor.json

@@ -0,0 +1,22 @@
+{
+	"actorSpecification": 1,
+	"name": "winston-mcp-server",
+	"title": "Winston AI MCP server",
+	"description": "Run the Winston AI Model Context Protocol server, giving language models real-time access to advanced AI text and image detection, plagiarism checks, and text comparison capabilities.",
+	"version": "0.0",
+	"buildTag": "latest",
+	"usesStandbyMode": true,
+	"meta": {
+		"templateId": "ts-mcp-server"
+	},
+	"input": {
+		"title": "Actor input schema",
+		"description": "This is Actor input schema",
+		"type": "object",
+		"schemaVersion": 1,
+		"properties": {},
+		"required": []
+	},
+	"dockerfile": "../Dockerfile",
+	"webServerMcpPath": "/mcp"
+}

winston-mcp-server/.actor/pay_per_event.json

@@ -0,0 +1,14 @@
+{
+    "tool-request": {
+        "eventTitle": "Generic Tool Request",
+        "eventDescription": "Fallback charge for unclassified or generic tool calls.",
+        "eventPriceUsd": 0.0005,
+        "unit": "call"
+    },
+    "winston-ai-credits-consumed": {
+        "eventTitle": "Input count based price event",
+        "eventDescription": "Event fired by input-based tools, where the price is determined by token consumption.",
+        "eventPriceUsd": 0.000058,
+        "unit": "call"
+    }
+}

winston-mcp-server/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+end_of_line = lf

winston-mcp-server/.gitignore

@@ -0,0 +1,14 @@
+# This file tells Git which files shouldn't be added to source control
+
+.idea
+.vscode
+.zed
+storage
+apify_storage
+crawlee_storage
+node_modules
+dist
+tsconfig.tsbuildinfo
+
+# Added by Apify CLI
+.venv

winston-mcp-server/.prettierignore

@@ -0,0 +1 @@
+.prettierignore

winston-mcp-server/.prettierrc

@@ -0,0 +1,5 @@
+{
+    "printWidth": 120,
+    "singleQuote": true,
+    "tabWidth": 4
+}

winston-mcp-server/Dockerfile

@@ -0,0 +1,56 @@
+# Specify the base Docker image. You can read more about
+# the available images at https://docs.apify.com/sdk/js/docs/guides/docker-images
+# You can also use any other image from Docker Hub.
+FROM apify/actor-node:22 AS builder
+
+# Check preinstalled packages
+RUN npm ls crawlee apify puppeteer playwright
+
+# Copy just package.json and package-lock.json
+# to speed up the build using Docker layer cache.
+COPY package*.json ./
+
+# Install all dependencies. Don't audit to speed up the installation.
+RUN npm install --include=dev --audit=false
+
+# Next, copy the source files using the user set
+# in the base image.
+COPY . ./
+
+# Install all dependencies and build the project.
+# Don't audit to speed up the installation.
+RUN npm run build
+
+# Create final image
+FROM apify/actor-node:22
+
+# Check preinstalled packages
+RUN npm ls crawlee apify puppeteer playwright
+
+# Copy just package.json and package-lock.json
+# to speed up the build using Docker layer cache.
+COPY package*.json ./
+
+# Install NPM packages, skip optional and development dependencies to
+# keep the image small. Avoid logging too much and print the dependency
+# tree for debugging
+RUN npm --quiet set progress=false \
+    && npm install --omit=dev --omit=optional \
+    && echo "Installed NPM packages:" \
+    && (npm list --omit=dev --all || true) \
+    && echo "Node.js version:" \
+    && node --version \
+    && echo "NPM version:" \
+    && npm --version \
+    && rm -r ~/.npm
+
+# Copy built JS files from builder image
+COPY --from=builder /usr/src/app/dist ./dist
+
+# Next, copy the remaining files and directories with the source code.
+# Since we do this after NPM install, quick build will be really fast
+# for most source file changes.
+COPY . ./
+
+# Run the image.
+CMD npm run start:prod --silent

winston-mcp-server/README.md

@@ -0,0 +1,83 @@
+## Winston AI MCP Server (Apify Actor)
+
+Run the **Winston AI Model Context Protocol (MCP) server** via this Apify Actor, giving language models **real-time access to advanced AI text and image detection, plagiarism checks, and sophisticated text comparison capabilities**. Use your Apify credits to integrate Winston AI's powerful detection features into your AI workflows—no fine-tuning required. ⚡️
+
+This Actor proxies the Winston AI MCP Server, allowing AI clients to integrate directly with Winston AI's detection and analysis capabilities. It requires a valid Winston AI API Key for authentication.
+
+About this MCP Server: To understand how to connect to and utilize MCP servers, please refer to the official Model Context Protocol documentation at [mcp.apify.com](https://mcp.apify.com).
+
+## Connection URL
+MCP clients can connect to this server at:
+
+```text
+https://mcp-servers--winston-ai-mcp-server.apify.actor/mcp
+```
+
+## Client configuration
+To connect to this MCP server, use the following configuration in your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "winston-ai": {
+      "url": "https://mcp-servers--winston-ai-mcp-server.apify.actor/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_APIFY_TOKEN"
+      },
+      "env": {
+        "WINSTONAI_API_KEY": "YOUR_WINSTON_AI_API_KEY"
+      }
+    }
+  }
+}
+```
+
+Note: Replace `YOUR_APIFY_TOKEN` with your actual Apify API token (find it in the [Apify Console](https://console.apify.com/account/integrations)). Also, set `WINSTONAI_API_KEY` with your actual Winston AI API Key, which you can obtain at [https://dev.gowinston.ai](https://dev.gowinston.ai). This key is essential for the Actor to authenticate with the Winston AI service.
+
+## 🚩 Claim this MCP server
+All credits to the original authors of the Winston AI MCP server implementation.
+To claim this server, please write to [[email protected]](mailto:[email protected]).
+
+---
+
+## 🛠️ Available Tools
+
+Your AI tool will have access to the following detection and analysis capabilities from Winston AI:
+
+| Tool Name                | Description                                                          |
+| :----------------------- | :------------------------------------------------------------------- |
+| `ai-text-detection`      | Classify text as human-generated or AI-generated, with sentence-level analysis. |
+| `ai-image-detection`     | Identify AI-generated images, including C2PA metadata and watermark detection. |
+| `plagiarism-detection`   | Perform internet-scale plagiarism scans with detailed source reports. |
+| `text-compare`           | Conduct bidirectional similarity analysis between two texts.        |
+
+Note: Refer to the Winston AI API Documentation (https://docs.gowinston.ai/api-reference/mcp-server) for detailed input parameters and usage of each tool.
+
+### ✨ Example Usage
+
+Your AI assistant should automatically use these tools for content analysis and detection.
+
+#### AI Content Detection
+- "Check if this article about quantum computing was written by an AI or a human." (Uses `ai-text-detection`)
+- "Analyze this image: [image URL]. Is it AI-generated?" (Uses `ai-image-detection`)
+
+#### Plagiarism & Comparison
+- "Scan this essay for plagiarism against online sources." (Uses `plagiarism-detection`)
+- "Compare these two text snippets for similarity: 'First text...' and 'Second text...'" (Uses `text-compare`)
+
+## References
+To learn more about Apify and Actors, take a look at the following resources:
+- [Apify SDK for JavaScript documentation](https://docs.apify.com/sdk/js)
+- [Apify SDK for Python documentation](https://docs.apify.com/sdk/python)
+- [Apify Platform documentation](https://docs.apify.com/platform)
+- [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp)
+- [Model Context Protocol documentation](https://mcp.apify.com)
+- [Webinar: Building and Monetizing MCP Servers on Apify](https://www.youtube.com/watch?v=w3AH3jIrXXo)
+- [Join our developer community on Discord](https://discord.com/invite/jyEM2PRvMU)
+
+### Notes and Best Practices
+
+*   **Authentication:** This Apify Actor requires your Apify API token for access. The Actor itself authenticates with the Winston AI service using the `WINSTONAI_API_KEY` provided as an environment variable to the Actor. This key is crucial for the Actor's functionality. Obtain yours at [https://dev.gowinston.ai](https://dev.gowinston.ai).
+*   **Rate Limits and Quotas:** Winston AI APIs and your Actor may enforce rate limits and have associated credit costs. Implement backoff/retry where appropriate and monitor your usage.
+*   **Content Limits:** Be aware of minimum and maximum character/text/image size limits for Winston AI tools.
+*   **Compliance:** Ensure your usage complies with your organization’s data governance and Winston AI’s terms of service.

winston-mcp-server/eslint.config.mjs

@@ -0,0 +1,30 @@
+import prettier from 'eslint-config-prettier';
+
+import apify from '@apify/eslint-config/ts.js';
+import globals from 'globals';
+import tsEslint from 'typescript-eslint';
+
+// eslint-disable-next-line import/no-default-export
+export default [
+    { ignores: ['**/dist', 'eslint.config.mjs'] },
+    ...apify,
+    prettier,
+    {
+        languageOptions: {
+            parser: tsEslint.parser,
+            parserOptions: {
+                project: 'tsconfig.json',
+            },
+            globals: {
+                ...globals.node,
+                ...globals.jest,
+            },
+        },
+        plugins: {
+            '@typescript-eslint': tsEslint.plugin,
+        },
+        rules: {
+            'no-console': 0,
+        },
+    },
+];