blackmount-nlp-mcp

Install in Cursor

PyPI version PyPI Downloads Tests License: MIT Python 3.10+ Awesome MCP

Deterministic local text analysis for Claude Desktop, Cursor, Cline, and any MCP client. Built by Blackmount.

45 text analysis tools as a FastMCP server — sentiment, readability, keywords, similarity, summarization, language detection. No NLTK. No spaCy. No transformers. No API keys. One dependency (mcp[cli]), 42 KB wheel, installs in seconds. Python 3.10+.

Why this exists

	blackmount-nlp-mcp	NLTK	spaCy	transformers
Wheel size	42 KB	1.5 MB	6 MB+ (+ models)	10 MB+ (+ models)
Direct dependencies	1	many	many	many
Tokenization	✅	✅	✅	✅
Sentiment analysis	✅	✅	❌	✅
Readability scores	✅	❌	❌	❌
Keyword extraction	✅	✅	❌	❌
Text similarity	✅	✅	✅	✅
Language detection	✅ (18 langs)	❌	❌	❌

Everything is implemented from scratch in pure Python — Porter stemmer, TF-IDF, RAKE, Levenshtein, VADER-style sentiment, Flesch / Gunning Fog / Coleman-Liau / ARI / SMOG readability, extractive summarization, language detection — plus a built-in 2000+ word sentiment lexicon and 500+ stopword list, all baked into the package.

Quick start

pip install blackmount-nlp-mcp

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nlp": {
      "command": "blackmount-nlp-mcp"
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "nlp": {
      "command": "blackmount-nlp-mcp"
    }
  }
}

Any MCP client

The server runs over stdio. Point your client at the blackmount-nlp-mcp command:

blackmount-nlp-mcp

Restart your editor. All 45 NLP tools are now available — just ask in natural language.

Tool catalog

Tokenization (4 tools)

Tool	Description	Try asking
`word_tokenize`	Split text into words, handling contractions and punctuation	"Tokenize this paragraph into words"
`sentence_tokenize`	Split into sentences, handling common abbreviations	"Break this text into individual sentences"
`generate_ngrams`	Generate word-level n-grams from a token list	"Generate bigrams from these tokens"
`generate_char_ngrams`	Generate character-level n-grams	"Get character trigrams for this word"

Readability (8 tools)

All readability functions return 0.0 for empty or whitespace-only input.

Tool	Description	Try asking
`flesch_reading_ease`	0–100 ease score (higher = easier)	"Calculate the Flesch Reading Ease score"
`flesch_kincaid_grade`	US grade level estimate	"What grade level is this written at?"
`gunning_fog_index`	Fog index based on complex word ratio	"Calculate the Fog index for this text"
`coleman_liau_index`	Coleman-Liau grade-level index	"Get the Coleman-Liau score"
`automated_readability_index`	ARI grade-level index	"What's the ARI for this document?"
`smog_grade_index`	SMOG grade (recommended for healthcare text)	"Calculate the SMOG grade for this document"
`count_syllables`	Syllable count estimation for any word	"How many syllables in 'extraordinary'?"
`get_reading_level`	All readability scores in one call with a plain-English label	"Give me a full readability report for this text"

Sentiment Analysis (4 tools)

Tool	Description	Try asking
`get_sentiment_score`	Compound sentiment score from −1.0 to +1.0	"What's the sentiment of this customer review?"
`get_sentiment_label`	Returns `positive`, `negative`, or `neutral`	"Is this feedback positive or negative?"
`get_sentence_sentiments`	Per-sentence sentiment breakdown	"Show me the sentiment of each sentence"
`get_aspect_sentiment`	Sentiment scoped to specific topics	"What's the sentiment around 'pricing' in these reviews?"

Keyword Extraction (4 tools)

Tool	Description	Try asking
`extract_tfidf_keywords`	TF-IDF keyword ranking across a corpus	"What are the key terms across these docs?"
`extract_rake_keywords`	RAKE algorithm — phrase-level keyword extraction	"Extract the key phrases from this article"
`get_word_frequency`	Top words by frequency, stopwords excluded	"What are the most common words in this text?"
`get_phrase_frequency`	Top n-gram phrases by frequency	"What two-word phrases appear most often?"

Text Similarity (5 tools)

Tool	Description	Try asking
`get_jaccard_similarity`	Word-set overlap, 0–1	"How similar are these two paragraphs?"
`get_cosine_similarity`	Bag-of-words cosine similarity, 0–1	"Calculate cosine similarity between these texts"
`get_edit_distance`	Levenshtein edit distance	"How many edits to turn 'kitten' into 'sitting'?"
`get_normalized_edit_distance`	Edit distance normalized to 0–1	"How different are these two strings?"
`get_longest_common_subsequence`	LCS length between two strings	"What's the LCS length of these two strings?"

Text Cleaning (10 tools)

Tool	Description	Try asking
`clean_remove_stopwords`	Strip 500+ English stopwords	"Remove stopwords from this text"
`clean_remove_punctuation`	Remove all punctuation	"Strip the punctuation"
`clean_remove_numbers`	Remove numeric tokens	"Remove all numbers from this"
`clean_remove_urls`	Strip URLs	"Clean out the URLs"
`clean_remove_emails`	Strip email addresses	"Remove email addresses from this text"
`clean_remove_html`	Strip HTML tags	"Strip the HTML from this content"
`clean_normalize_whitespace`	Collapse and trim whitespace	"Normalize the whitespace"
`clean_lowercase`	Lowercase the text	"Convert this to lowercase"
`porter_stem`	Porter stemmer (pure Python, no NLTK)	"Stem the word 'running'"
`clean_text_pipeline`	Configurable multi-step cleaning in one call	"Clean this text: remove HTML, URLs, and stopwords"

Detection (8 tools)

Tool	Description	Try asking
`detect_text_language`	Identify language from 18 supported languages	"What language is this text written in?"
`detect_text_encoding_type`	Detect script: ASCII, Latin, Cyrillic, CJK, Arabic	"What script does this text use?"
`check_is_english`	English confidence score, 0–1	"Is this text in English?"
`count_words`	Word count	"How many words are in this?"
`count_sentences`	Sentence count	"Count the sentences"
`count_paragraphs`	Paragraph count	"How many paragraphs?"
`get_avg_word_length`	Mean word length in characters	"What's the average word length?"
`get_avg_sentence_length`	Mean sentence length in words	"How long are the sentences on average?"

Summarization (2 tools)

Tool	Description	Try asking
`get_extractive_summary`	Select the N highest-scoring sentences from a document	"Summarize this article in 3 sentences"
`get_text_statistics`	Full document stats: words, readability, language, reading time	"Give me a statistical profile of this text"

Use as a library

The submodules are importable directly — no MCP server required:

from blackmount_nlp_mcp.sentiment import sentiment_score, sentiment_label
from blackmount_nlp_mcp.readability import reading_level
from blackmount_nlp_mcp.keywords import rake_keywords

text = "This product is absolutely amazing! The quality is excellent."

print(sentiment_score(text))
# 0.9285

print(sentiment_label(text))
# 'positive'

print(reading_level(text))
# {'grade_level': 12.39, 'label': 'college',
#  'flesch_reading_ease': 14.27, 'flesch_kincaid_grade': 12.39,
#  'gunning_fog': 19.58, 'coleman_liau': 10.94,
#  'automated_readability': 7.51, 'smog_grade': 11.21}

print(rake_keywords(text))
# [{'phrase': 'absolutely amazing', 'score': 4.0},
#  {'phrase': 'product', 'score': 1.0},
#  {'phrase': 'quality', 'score': 1.0},
#  {'phrase': 'excellent', 'score': 1.0}]

Development

git clone https://github.com/BlackMount-ai/blackmount-nlp-mcp
cd blackmount-nlp-mcp
pip install -e .
pytest tests/ -v

Blackmount ecosystem

blackmount-nlp-mcp is built by Blackmount — tools for people who work with AI.

blackmount-mcp — Local browser context (history, bookmarks, tabs, downloads) as an MCP server. Pair it with blackmount-nlp-mcp to analyze your browsing: extract keywords from page titles, summarize research topics, detect reading-level trends across the sites you visit.

app.blackmount.ai — The full Blackmount platform. Search, organize, and analyze everything your AI tools produce.

Star History

License

MIT