Skip to content

io.github.nexus-mcp-infra/similarity-search-api-sdk

by nexus-mcp-infra · remote · no sign-in to list tools · v1.0.0 · published by GitHub user nexus-mcp-infra

Stateless NMI + cosine fusion with entropy-driven alpha calibration

Read only

3 tools: 3 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http similarity-search-api-sdk https://similarity-search-api-production.up.railway.app/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

3 tools

Only reads 3Claude Code: allow
  • nexus_similarity_search_api_estimate_corpus_entropy_profileComputes the aggregate entropy-calibrated alpha for a corpus without running a full search -- useful to inspect before committing to a large rank_items_by_nmi_cosine_fusion call.No findings

    Why it is in this group

    • The name "nexus_similarity_search_api_estimate_corpus_entropy_profile" says "search": a word for reading.
    Description, as the server wrote it
    Computes the aggregate entropy-calibrated alpha for a corpus without running a full search -- useful to inspect before committing to a large rank_items_by_nmi_cosine_fusion call. Returns a single aggregate corpus_entropy value, NOT a per-dimension breakdown -- the real logic only exposes the mean marginal entropy across dimensions, not H(X_d) per individual dimension. Do NOT use expecting per-dimension granularity. Requires an x402 payment.
  • nexus_similarity_search_api_rank_items_by_nmi_cosine_fusionRanks a corpus of items against a query vector using a calibrated fusion score (alpha * cosine + (1-alpha) * NMI_normalizado), where alpha is auto-derived from the corpus's margina…No findings

    Why it is in this group

    • The name "nexus_similarity_search_api_rank_items_by_nmi_cosine_fusion" says "search": a word for reading.
    Description, as the server wrote it
    Ranks a corpus of items against a query vector using a calibrated fusion score (alpha * cosine + (1-alpha) * NMI_normalizado), where alpha is auto-derived from the corpus's marginal entropy unless overridden. Results are identified by their 0-indexed position in corpus_vectors (this tool does not accept explicit item IDs). Use this when you need semantically-calibrated similarity over a stateless corpus of up to 500k items without a vector database. Do NOT use for purely geometric nearest-neighbor search where NMI overhead is unnecessary, nor for corpora larger than 500k items per call. Requires an x402 payment.
  • nexus_similarity_search_api_score_pair_nmi_cosineComputes the NMI-cosine fusion score for exactly one (query, target) vector pair at a fixed alpha.No findings

    Why it is in this group

    • The name "nexus_similarity_search_api_score_pair_nmi_cosine" says "search": a word for reading.
    Description, as the server wrote it
    Computes the NMI-cosine fusion score for exactly one (query, target) vector pair at a fixed alpha. Use for explainability, debugging, or unit-level validation of fusion scores before running full corpus ranking. Unlike corpus-level ranking, alpha is NOT auto-calibrated for a single pair -- the real logic requires a fixed alpha (default 0.5); pass alpha explicitly for a specific blend. Do NOT use in a loop to score many pairs; batch them into rank_items_by_nmi_cosine_fusion instead. Requires an x402 payment.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http similarity-search-api-sdk https://similarity-search-api-production.up.railway.app/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__similarity-search-api-sdk__nexus_similarity_search_api_rank_items_by_nmi_cosine_fusion",
      "mcp__similarity-search-api-sdk__nexus_similarity_search_api_estimate_corpus_entropy_profile",
      "mcp__similarity-search-api-sdk__nexus_similarity_search_api_score_pair_nmi_cosine"
    ],
    "ask": [],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as similarity-search-api-sdk. Review it before you use it.