semantic_searchLABSCO SUMMARY
It searches collections; it does not build them.
Every tool takes a collection name, which means the indexing work happens on the Jina side before this is useful at all — connect it to an existing collection rather than expecting it to ingest your data. Once that is true, cross-modal is the capability worth having: describing what you are looking for in words and getting images back is not something a keyword index can do.
What it is
A search client for Jina AI's neural search. Three tools query a named collection: by meaning over text, by visual similarity from an image URL, and across the two — text describing an image, or an image finding text.
What you get
semantic_searchtakes aquery, acollectionand an optionallimit(default 10)image_searchtakes animageUrland finds visually similar images in the same collectioncross_modal_searchtakes amodeoftext2imageorimage2text, so a sentence can find pictures or a picture can find text- Every result carries an
id, a numericscoreand itsdata, so ranking is visible rather than implied - Errors are typed and returned rather than thrown — invalid keys, bad parameters, rate limits, network failures and unknown collection names each come back with a code
Requirements
Node.js 16 or higher, and a Jina AI account with an API key from https://cloud.jina.ai/. Published as jina-ai-mcp version 1.0.0; the documented path is clone, npm install, put JINA_API_KEY in a .env file, npm run build, then point your client at build/index.js with the key in the entry's env. Every call names a collection, so the collections have to exist on the Jina side first — this server searches them, it does not create or index them.
Setup effort
Build from source — git clone https://github.com/Sheshiyer/jina-ai-mcp-multimodal-search.git
USE CASES
Finding documents that mean the same thing
Search by intent rather than exact wording and see the similarity score for each hit.
Finding near-duplicates of an image
Pass an image URL and get visually similar entries from the same collection.
Describing a picture you want
Ask in words and get images back, without tags or filenames having to match.
Working out what an image is about
Run the search the other way — image in, related text out.
3 tools
Listed in project docs. Your client may show a different list.
image_searchcross_modal_searchBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
- Node.js 16 or later
- JINA_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
git clone https://github.com/Sheshiyer/jina-ai-mcp-multimodal-search.git
cd jina-ai-mcp-multimodal-search
npm installCreate a .env file in the clone containing JINA_API_KEY=<YOUR_JINA_API_KEY>, with your key from https://cloud.jina.ai/.
npm run buildMCP Clients
Any MCP client
{
"mcpServers": {
"jina-ai": {
"command": "node",
"args": [
"<YOUR_PATH_TO_JINA_AI_MCP_MULTIMODAL>/build/index.js"
],
"env": {
"JINA_API_KEY": "<YOUR_JINA_API_KEY>"
}
}
}
}