@safenest/mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SafeNest
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,166 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SafeNestSDK/mcp/main/assets/logo.png" alt="SafeNest" width="200" />
+</p>
+
+<h1 align="center">SafeNest MCP Server</h1>
+
+<p align="center">
+  <strong>MCP server for SafeNest - AI-powered child safety tools for Claude</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@safenest/mcp"><img src="https://img.shields.io/npm/v/@safenest/mcp.svg" alt="npm version"></a>
+  <a href="https://github.com/SafeNestSDK/mcp/blob/main/LICENSE"><img src="https://img.shields.io/github/license/SafeNestSDK/mcp.svg" alt="license"></a>
+</p>
+
+<p align="center">
+  <a href="https://api.safenest.dev/docs">API Docs</a> •
+  <a href="https://safenest.app">Dashboard</a> •
+  <a href="https://discord.gg/7kbTeRYRXD">Discord</a>
+</p>
+
+---
+
+## What is this?
+
+SafeNest MCP Server brings AI-powered child safety tools directly into Claude, Cursor, and other MCP-compatible AI assistants. Ask Claude to check messages for bullying, detect grooming patterns, or generate safety action plans.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `detect_bullying` | Analyze text for bullying, harassment, or harmful language |
+| `detect_grooming` | Detect grooming patterns and predatory behavior in conversations |
+| `detect_unsafe` | Identify unsafe content (self-harm, violence, explicit material) |
+| `analyze` | Quick comprehensive safety check (bullying + unsafe) |
+| `analyze_emotions` | Analyze emotional content and mental state indicators |
+| `get_action_plan` | Generate age-appropriate guidance for safety situations |
+| `generate_report` | Create incident reports from conversations |
+
+---
+
+## Installation
+
+### Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):
+
+```json
+{
+  "mcpServers": {
+    "safenest": {
+      "command": "npx",
+      "args": ["-y", "@safenest/mcp"],
+      "env": {
+        "SAFENEST_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to your Cursor MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "safenest": {
+      "command": "npx",
+      "args": ["-y", "@safenest/mcp"],
+      "env": {
+        "SAFENEST_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Global Install
+
+```bash
+npm install -g @safenest/mcp
+```
+
+Then run:
+```bash
+SAFENEST_API_KEY=your-api-key safenest-mcp
+```
+
+---
+
+## Usage Examples
+
+Once configured, you can ask Claude:
+
+### Bullying Detection
+> "Check if this message is bullying: 'Nobody likes you, just go away'"
+
+**Response:**
+```
+## ⚠️ Bullying Detected
+
+**Severity:** 🟠 Medium
+**Confidence:** 92%
+**Risk Score:** 75%
+
+**Types:** exclusion, verbal_abuse
+
+### Rationale
+The message contains direct exclusionary language...
+
+### Recommended Action
+`flag_for_moderator`
+```
+
+### Grooming Detection
+> "Analyze this conversation for grooming patterns..."
+
+### Quick Safety Check
+> "Is this message safe? 'I don't want to be here anymore'"
+
+### Emotion Analysis
+> "Analyze the emotions in: 'I'm so stressed about school and nobody understands'"
+
+### Action Plan
+> "Give me an action plan for a 12-year-old being cyberbullied"
+
+### Incident Report
+> "Generate an incident report from these messages..."
+
+---
+
+## Get an API Key
+
+1. Go to [safenest.app](https://safenest.app)
+2. Create an account
+3. Generate an API key
+4. Add it to your MCP config
+
+---
+
+## Requirements
+
+- Node.js 18+
+- SafeNest API key
+
+---
+
+## Support
+
+- **API Docs**: [api.safenest.dev/docs](https://api.safenest.dev/docs)
+- **Discord**: [discord.gg/7kbTeRYRXD](https://discord.gg/7kbTeRYRXD)
+- **Email**: support@safenest.dev
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+<p align="center">
+  <sub>Built with care for child safety by the <a href="https://safenest.dev">SafeNest</a> team</sub>
+</p>

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,410 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const sdk_1 = require("@safenest/sdk");
+// Initialize SafeNest client
+const apiKey = process.env.SAFENEST_API_KEY;
+if (!apiKey) {
+    console.error('Error: SAFENEST_API_KEY environment variable is required');
+    process.exit(1);
+}
+const client = new sdk_1.SafeNestClient(apiKey);
+// Severity emoji mapping
+const severityEmoji = {
+    low: '🟡',
+    medium: '🟠',
+    high: '🔴',
+    critical: '⛔',
+};
+const riskEmoji = {
+    safe: '✅',
+    none: '✅',
+    low: '🟡',
+    medium: '🟠',
+    high: '🔴',
+    critical: '⛔',
+};
+const trendEmoji = {
+    improving: '📈',
+    stable: '➡️',
+    worsening: '📉',
+};
+// Tool definitions
+const tools = [
+    {
+        name: 'detect_bullying',
+        description: 'Analyze text content to detect bullying, harassment, or harmful language. Returns severity, type of bullying, confidence score, and recommended actions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'The text content to analyze for bullying',
+                },
+                context: {
+                    type: 'object',
+                    description: 'Optional context for better analysis',
+                    properties: {
+                        language: { type: 'string' },
+                        ageGroup: { type: 'string' },
+                        relationship: { type: 'string' },
+                        platform: { type: 'string' },
+                    },
+                },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'detect_grooming',
+        description: 'Analyze a conversation for grooming patterns and predatory behavior. Identifies manipulation tactics, boundary violations, and isolation attempts.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                messages: {
+                    type: 'array',
+                    description: 'Array of messages in the conversation',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            role: {
+                                type: 'string',
+                                enum: ['adult', 'child', 'unknown'],
+                                description: 'Role of the message sender',
+                            },
+                            content: {
+                                type: 'string',
+                                description: 'Message content',
+                            },
+                        },
+                        required: ['role', 'content'],
+                    },
+                },
+                childAge: {
+                    type: 'number',
+                    description: 'Age of the child in the conversation',
+                },
+            },
+            required: ['messages'],
+        },
+    },
+    {
+        name: 'detect_unsafe',
+        description: 'Detect unsafe content including self-harm, violence, drugs, explicit material, or other harmful content categories.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'The text content to analyze for unsafe content',
+                },
+                context: {
+                    type: 'object',
+                    description: 'Optional context for better analysis',
+                    properties: {
+                        language: { type: 'string' },
+                        ageGroup: { type: 'string' },
+                        platform: { type: 'string' },
+                    },
+                },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'analyze',
+        description: 'Quick comprehensive safety analysis that checks for both bullying and unsafe content. Best for general content screening.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'The text content to analyze',
+                },
+                include: {
+                    type: 'array',
+                    items: { type: 'string', enum: ['bullying', 'unsafe'] },
+                    description: 'Which checks to run (default: both)',
+                },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'analyze_emotions',
+        description: 'Analyze emotional content and mental state indicators. Identifies dominant emotions, trends, and provides follow-up recommendations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'The text content to analyze for emotions',
+                },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'get_action_plan',
+        description: 'Generate age-appropriate guidance and action steps for handling a safety situation. Tailored for children, parents, or educators.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                situation: {
+                    type: 'string',
+                    description: 'Description of the situation needing guidance',
+                },
+                childAge: {
+                    type: 'number',
+                    description: 'Age of the child involved',
+                },
+                audience: {
+                    type: 'string',
+                    enum: ['child', 'parent', 'educator', 'platform'],
+                    description: 'Who the guidance is for (default: parent)',
+                },
+                severity: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'critical'],
+                    description: 'Severity of the situation',
+                },
+            },
+            required: ['situation'],
+        },
+    },
+    {
+        name: 'generate_report',
+        description: 'Generate a comprehensive incident report from a conversation. Includes summary, risk level, and recommended next steps.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                messages: {
+                    type: 'array',
+                    description: 'Array of messages in the incident',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            sender: { type: 'string', description: 'Name/ID of sender' },
+                            content: { type: 'string', description: 'Message content' },
+                        },
+                        required: ['sender', 'content'],
+                    },
+                },
+                childAge: {
+                    type: 'number',
+                    description: 'Age of the child involved',
+                },
+                incidentType: {
+                    type: 'string',
+                    description: 'Type of incident (e.g., bullying, grooming)',
+                },
+            },
+            required: ['messages'],
+        },
+    },
+];
+// Create MCP server
+const server = new index_js_1.Server({
+    name: 'safenest-mcp',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List tools handler
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return { tools };
+});
+// Call tool handler
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    try {
+        switch (name) {
+            case 'detect_bullying': {
+                const result = await client.detectBullying({
+                    content: args.content,
+                    context: args.context,
+                });
+                const emoji = severityEmoji[result.severity] || '⚪';
+                const response = `## ${result.is_bullying ? '⚠️ Bullying Detected' : '✅ No Bullying Detected'}
+
+**Severity:** ${emoji} ${result.severity.charAt(0).toUpperCase() + result.severity.slice(1)}
+**Confidence:** ${(result.confidence * 100).toFixed(0)}%
+**Risk Score:** ${(result.risk_score * 100).toFixed(0)}%
+
+${result.is_bullying ? `**Types:** ${result.bullying_type.join(', ')}` : ''}
+
+### Rationale
+${result.rationale}
+
+### Recommended Action
+\`${result.recommended_action}\``;
+                return { content: [{ type: 'text', text: response }] };
+            }
+            case 'detect_grooming': {
+                const messages = args.messages.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                }));
+                const result = await client.detectGrooming({
+                    messages,
+                    childAge: args.childAge,
+                });
+                const emoji = riskEmoji[result.grooming_risk] || '⚪';
+                const response = `## ${result.grooming_risk === 'none' ? '✅ No Grooming Detected' : '⚠️ Grooming Risk Detected'}
+
+**Risk Level:** ${emoji} ${result.grooming_risk.charAt(0).toUpperCase() + result.grooming_risk.slice(1)}
+**Confidence:** ${(result.confidence * 100).toFixed(0)}%
+**Risk Score:** ${(result.risk_score * 100).toFixed(0)}%
+
+${result.flags.length > 0 ? `**Warning Flags:**\n${result.flags.map(f => `- 🚩 ${f}`).join('\n')}` : ''}
+
+### Rationale
+${result.rationale}
+
+### Recommended Action
+\`${result.recommended_action}\``;
+                return { content: [{ type: 'text', text: response }] };
+            }
+            case 'detect_unsafe': {
+                const result = await client.detectUnsafe({
+                    content: args.content,
+                    context: args.context,
+                });
+                const emoji = severityEmoji[result.severity] || '⚪';
+                const response = `## ${result.unsafe ? '⚠️ Unsafe Content Detected' : '✅ Content is Safe'}
+
+**Severity:** ${emoji} ${result.severity.charAt(0).toUpperCase() + result.severity.slice(1)}
+**Confidence:** ${(result.confidence * 100).toFixed(0)}%
+**Risk Score:** ${(result.risk_score * 100).toFixed(0)}%
+
+${result.unsafe ? `**Categories:**\n${result.categories.map(c => `- ⚠️ ${c}`).join('\n')}` : ''}
+
+### Rationale
+${result.rationale}
+
+### Recommended Action
+\`${result.recommended_action}\``;
+                return { content: [{ type: 'text', text: response }] };
+            }
+            case 'analyze': {
+                const result = await client.analyze({
+                    content: args.content,
+                    include: args.include,
+                });
+                const emoji = riskEmoji[result.risk_level] || '⚪';
+                const response = `## Safety Analysis Results
+
+**Overall Risk:** ${emoji} ${result.risk_level.charAt(0).toUpperCase() + result.risk_level.slice(1)}
+**Risk Score:** ${(result.risk_score * 100).toFixed(0)}%
+
+### Summary
+${result.summary}
+
+### Recommended Action
+\`${result.recommended_action}\`
+
+---
+${result.bullying ? `
+**Bullying Check:** ${result.bullying.is_bullying ? '⚠️ Detected' : '✅ Clear'}
+` : ''}${result.unsafe ? `
+**Unsafe Content:** ${result.unsafe.unsafe ? '⚠️ Detected' : '✅ Clear'}
+` : ''}`;
+                return { content: [{ type: 'text', text: response }] };
+            }
+            case 'analyze_emotions': {
+                const result = await client.analyzeEmotions({
+                    content: args.content,
+                });
+                const emoji = trendEmoji[result.trend] || '➡️';
+                // Format emotion scores
+                const emotionScoresList = Object.entries(result.emotion_scores)
+                    .sort((a, b) => b[1] - a[1])
+                    .map(([emotion, score]) => `- ${emotion}: ${(score * 100).toFixed(0)}%`)
+                    .join('\n');
+                const response = `## Emotion Analysis
+
+**Dominant Emotions:** ${result.dominant_emotions.join(', ')}
+**Trend:** ${emoji} ${result.trend.charAt(0).toUpperCase() + result.trend.slice(1)}
+
+### Emotion Scores
+${emotionScoresList}
+
+### Summary
+${result.summary}
+
+### Recommended Follow-up
+${result.recommended_followup}`;
+                return { content: [{ type: 'text', text: response }] };
+            }
+            case 'get_action_plan': {
+                const result = await client.getActionPlan({
+                    situation: args.situation,
+                    childAge: args.childAge,
+                    audience: args.audience,
+                    severity: args.severity,
+                });
+                const response = `## Action Plan
+
+**Audience:** ${result.audience}
+**Tone:** ${result.tone}
+${result.reading_level ? `**Reading Level:** ${result.reading_level}` : ''}
+
+### Steps
+${result.steps.map((step, i) => `${i + 1}. ${step}`).join('\n')}`;
+                return { content: [{ type: 'text', text: response }] };
+            }
+            case 'generate_report': {
+                const messages = args.messages.map((m) => ({
+                    sender: m.sender,
+                    content: m.content,
+                }));
+                const result = await client.generateReport({
+                    messages,
+                    childAge: args.childAge,
+                    incident: args.incidentType ? { type: args.incidentType } : undefined,
+                });
+                const emoji = riskEmoji[result.risk_level] || '⚪';
+                const response = `## 📋 Incident Report
+
+**Risk Level:** ${emoji} ${result.risk_level.charAt(0).toUpperCase() + result.risk_level.slice(1)}
+
+### Summary
+${result.summary}
+
+### Categories
+${result.categories.map(c => `- ${c}`).join('\n')}
+
+### Recommended Next Steps
+${result.recommended_next_steps.map((step, i) => `${i + 1}. ${step}`).join('\n')}`;
+                return { content: [{ type: 'text', text: response }] };
+            }
+            default:
+                return {
+                    content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('SafeNest MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@safenest/mcp",
+  "version": "1.0.0",
+  "description": "MCP server for SafeNest - AI-powered child safety analysis tools for Claude and other AI assistants",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "safenest-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "safenest",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "child-safety",
+    "content-moderation",
+    "bullying-detection"
+  ],
+  "author": "SafeNest <sales@safenest.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SafeNestSDK/mcp.git"
+  },
+  "homepage": "https://safenest.dev",
+  "bugs": {
+    "url": "https://github.com/SafeNestSDK/mcp/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@safenest/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}