glin-profanity-mcp

> Part of glin-profanity - MCP server for AI assistants


MCP (Model Context Protocol) server for glin-profanity - enables AI assistants like Claude Desktop, Cursor, Windsurf, and other MCP-compatible tools to use profanity detection and content moderation as native tools.

What is MCP?

The Model Context Protocol (MCP) is an open standard developed by Anthropic that allows AI assistants to securely access external tools and data sources. This package turns glin-profanity into an MCP server that AI assistants can use for content moderation.

Features

- 19 Powerful Tools for comprehensive content moderation
- 4 Workflow Prompts for guided AI interactions
- 5 Reference Resources for configuration and best practices
- 24 Language Support - Arabic, Chinese, English, French, German, Spanish, and more
- Context-Aware Analysis - Domain-specific whitelists reduce false positives
- Obfuscation Detection - Catches leetspeak (f4ck) and Unicode tricks
- Batch Processing - Check multiple texts efficiently
- Content Scoring - Get safety scores for moderation decisions

Installation

$3

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

``json
{
"mcpServers": {
"glin-profanity": {
"command": "npx",
"args": ["-y", "glin-profanity-mcp"]
}
}
}
`

$3

Add to your Cursor MCP settings (.cursor/mcp.json in your project or global config):

`json
{
"mcpServers": {
"glin-profanity": {
"command": "npx",
"args": ["-y", "glin-profanity-mcp"]
}
}
}
`

$3

`json
{
"mcpServers": {
"glin-profanity": {
"command": "npx",
"args": ["-y", "glin-profanity-mcp"]
}
}
}
`

$3

`bash
npm install -g glin-profanity-mcp

Then use in config:


{
"mcpServers": {
"glin-profanity": {
"command": "glin-profanity-mcp"
}
}
}
`

---

Available Tools (12)

$3

#### 1. check_profanity
Check text for profanity with detailed results.

`
"Check this user comment for profanity: 'Your product is sh1t'"
`

Parameters:
- text (required): Text to check
- languages: Array of languages (default: all)
- detectLeetspeak: Detect f4ck, sh1t patterns
- normalizeUnicode: Detect Unicode tricks
- customWords: Additional words to flag
- ignoreWords: Words to whitelist

---

#### 2. censor_text
Censor profanity by replacing with asterisks or custom characters.

`
"Censor this message: 'What the hell is going on?'"
`

Parameters:
- text (required): Text to censor
- replaceWith: Replacement character (default: *)
- preserveFirstLetter: Keep first letter (f instead of *)

---

#### 3. analyze_context
Context-aware analysis with domain-specific whitelists.

`
"Analyze this medical text: 'The patient has a breast tumor'"
`

Parameters:
- text (required): Text to analyze
- domain: medical, gaming, technical, educational, general
- contextWindow: Words to consider around matches (1-10)
- confidenceThreshold: Minimum confidence to flag (0-1)

---

#### 4. batch_check
Check multiple texts in one operation (up to 100).

`
"Batch check these comments: ['Great!', 'This sucks', 'Awesome']"
`

Parameters:
- texts (required): Array of texts (max 100)
- returnOnlyFlagged: Only return texts with profanity

---

#### 5. validate_content
Comprehensive content validation with safety scoring (0-100).

`
"Validate this blog post with high strictness"
`

Parameters:
- text (required): Content to validate
- strictness: low, medium, high
- context: Description of content type

Returns: Safety score, action recommendation (approve, review, edit, reject)

---

#### 6. detect_obfuscation
Detect text obfuscation techniques.

`
"Check if this uses obfuscation: 'Y0u @re an 1d10t'"
`

Detects: Leetspeak, Unicode homoglyphs, zero-width characters, spaced characters

---

#### 7. get_supported_languages
Get list of all 24 supported languages.

---

$3

#### 8. explain_match
Explain why a word was flagged with detailed reasoning.

`
"Explain why 'f4ck' was detected as profanity"
`

Returns:
- Detection method (direct, leetspeak, Unicode)
- Detailed reasoning
- Suggestions for handling

---

#### 9. suggest_alternatives
Suggest clean alternatives for profane content.

`
"Suggest alternatives for: 'This is shit' with professional tone"
`

Parameters:
- text (required): Text with profanity
- tone: formal, casual, humorous, professional

---

#### 10. analyze_corpus
Analyze a collection of texts for profanity statistics (up to 500 texts).

`
"Analyze these 100 user comments for a moderation report"
`

Returns:
- Profanity rate statistics
- Top profane words frequency
- Severity distribution
- Recommendations

---

#### 11. compare_strictness
Compare detection results across different strictness levels.

`
"Compare strictness levels for: 'You are such a n00b'"
`

Returns: Detection results at minimal, low, medium, high, and paranoid levels with recommendation.

---

#### 12. create_regex_pattern
Generate regex patterns for custom profanity detection.

`
"Create a regex pattern to catch variants of 'fuck'"
`

Parameters:
- word (required): Base word
- includeVariants: basic, moderate, aggressive

Returns: Ready-to-use regex patterns for JavaScript and Python.

---

Available Prompts (4)

MCP Prompts provide guided workflows for common tasks.

$3

Step-by-step content moderation workflow.

`
Use the content_moderation prompt with:
- content: "User comment to moderate"
- platform: "gaming" (or social_media, education, professional, general)
`

$3

Clean up content containing profanity for safe publishing.

`
Use the content_cleanup prompt with:
- content: "Text to clean up"
- preserveMeaning: true
`

$3

Generate a comprehensive moderation audit report.

`
Use the audit_report prompt with:
- description: "Weekly user comments audit"
`

$3

Tune profanity filter settings for your specific use case.

`
Use the filter_tuning prompt with:
- useCase: "Gaming chat moderation"
- sampleContent: "Example messages from your platform"
`

---

Available Resources (5)

Resources provide reference data accessible to AI assistants.

| Resource | URI | Description |
|----------|-----|-------------|
| Languages | glin-profanity://languages | All 24 supported languages with regional groupings |
| Config Examples | glin-profanity://config-examples | Ready-to-use configuration templates |
| Severity Levels | glin-profanity://severity-levels | Explanation of severity scoring |
| Domain Whitelists | glin-profanity://domain-whitelists | Domain-specific whitelist references |
| Detection Guide | glin-profanity://detection-guide | Guide to detection techniques and recommended configs |

---

Example Prompts for AI Assistants

$3


`
"Check this user comment for profanity"
"Censor the bad words in this message"
"What languages does glin-profanity support?"
`

$3

`
"Explain why this text was flagged and suggest alternatives"
"Compare strictness levels for this gaming chat message"
"Create a regex pattern to catch variants of [word]"
`

$3

`
"Analyze these 50 comments and give me a moderation report"
"Batch check all these messages and return only the flagged ones"
`

$3

`
"Analyze this medical article with medical domain context"
"Check this gaming chat with relaxed gaming platform rules"
`

$3

`
"Use the content_moderation workflow on this user submission"
"Help me tune my filter settings for an educational platform"
`

---

Use Cases

| Use Case | Recommended Tools |
|----------|-------------------|
| Chat moderation | check_profanity, censor_text, batch_check |
| Content publishing | validate_content, suggest_alternatives |
| Medical/Educational | analyze_context with domain parameter |
| Moderation dashboards | analyze_corpus, batch_check |
| Filter tuning | compare_strictness, filter_tuning prompt |
| Custom rules | create_regex_pattern |
| Understanding flags | explain_match |

---

Development

$3

`bash


Install dependencies

npm install

Build

npm run build

Run the server

npm start

Test with MCP Inspector

npm run inspect
`

$3

`bash
npx @anthropic-ai/mcp-inspector node dist/index.js
``

---

Supported Languages

| Region | Languages |
|--------|-----------|
| European | English, French, German, Spanish, Italian, Dutch, Portuguese, Polish, Czech, Danish, Finnish, Hungarian, Norwegian, Swedish, Esperanto |
| Asian | Chinese, Japanese, Korean, Thai, Hindi |
| Middle Eastern | Arabic, Persian, Turkish |
| Other | Russian |

---

License

MIT - See LICENSE for details.

Links

- Main glin-profanity repo
- MCP Documentation
- Report Issues