Skip to main content
Glama
Sign In
SignalRank MCP

SignalRank MCP

by bksampadi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

SignalRank MCP

MCP interface for SignalRank retrieval.

SignalRank MCP is a thin interoperability layer over SignalRank-RAG.

It exposes SignalRank retrieval to MCP-compatible clients without duplicating retrieval or ranking logic.

MCP client / host
       │
       ▼
SignalRank MCP
       │  authenticated HTTP
       ▼
SignalRank-RAG

Tool

search

Search SignalRank and return ranked evidence with provenance.

search(query, mode="dense", top_k=5)

Supported retrieval modes:

bm25
dense
hybrid

Results preserve:

chunk_id
doc_id
text
score
rank
source_path
metadata

Related MCP server: mcp-rag-search

Install

git clone https://github.com/bksampadi/signalrank-mcp.git
cd signalrank-mcp
uv sync --extra dev

Environment

SignalRank-RAG must be running.

Set the same service token for SignalRank-RAG and SignalRank MCP:

SIGNALRANK_SERVICE_TOKEN=signalrank-local-dev

SignalRank-RAG also requires:

GROQ_API_KEY=<your-groq-api-key>

SignalRank MCP defaults to:

SIGNALRANK_API_URL=http://127.0.0.1:8000

Do not commit API keys or production service tokens.

Run

Start SignalRank-RAG:

uv run uvicorn signalrank.api.main:app --host 127.0.0.1 --port 8000

Run with MCP Inspector:

uv run mcp dev src/signalrank_mcp/server.py --with-editable .

Or run directly over stdio:

uv run signalrank-mcp

Claude Code

Register the server:

claude mcp add --env SIGNALRANK_SERVICE_TOKEN=signalrank-local-dev --transport stdio signalrank -- uv run signalrank-mcp

Check the connection:

claude mcp get signalrank

Test

uv run pytest -q
uv run ruff check .
uv run pyright

Tested end-to-end with MCP Inspector and Claude Code.

License

MIT

Available Tools

1 tool
searchA

Search SignalRank and return ranked evidence without LLM synthesis.

Inputs: query (required), mode, top_k. Returns: mode, query, results

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no risk of selecting between overlapping operations. The single 'search' tool has a clear, singular purpose.

    Naming Consistency4/5

    The tool name 'search' is a clear, conventional verb, but with only one tool there is no broader verb_noun or convention pattern to evaluate. No inconsistency is present, though the naming style cannot be fully assessed.

    Tool Count3/5

    A single search tool forms a thin but functionally valid server for ranked-evidence lookup. It is at the low end of acceptable scope and may leave agents wanting supplementary operations.

    Completeness3/5

    The search operation covers the core retrieval use case, but the one-tool surface offers no way to fetch evidence by ID, filter results independently, or inspect sources. Secondary workflows may therefore dead-end.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-rag-search

      guo-yb-123
      F
      license
      Not graded
      quality
      C
      maintenance
      Enables agent tools like Claude Code and GitHub Copilot to perform knowledge retrieval using hybrid search (BM25 + dense) with reranking, via MCP protocol.
      -

    • rag-mcp-server

      Mily-Lv
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to query a modular RAG knowledge hub with hybrid dense/sparse retrieval, reranking, multimodal image support, and traceable observability, all through natural language tools.
      MIT

    • techdocs

      neminsuksen
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to search technical document collections using hybrid BM25 and embedding retrieval, returning cited page-level passages to support grounded, evidence-based answers.
      MIT