Searchcraft MCP Server

<img alt="ReTail website screenshot" src="./header.png"> <h1 align="center">searchcraft-mcp-server</h1> <p align="center"> An MCP Server powered by <a href="https://searchcraft.io">Searchcraft</a> – the developer-first vertical search engine. </p>

<p align="center"> <a href="https://www.typescriptlang.org/"> <img src="https://img.shields.io/badge/TypeScript-5.8-blue.svg?logo=typescript&style=flat" alt="TypeScript"> </a> <a href="https://nodejs.org/en/"> <img src="https://img.shields.io/badge/Node.js-20+-339933.svg?logo=node.js&style=flat" alt="Node.js"> </a> <a href="https://expressjs.com/"> <img src="https://img.shields.io/badge/Express-5.1-330033.svg?logo=express&style=flat" alt="Node.js"> </a> </p>

The Searchcraft MCP Server allows for easily integrating search into MCP clients. Integrates with things like Claude Desktop, which allows Claude to search for information on the search index that you specify.

Available Tools

get-search-results

Searches for information on the configured search index and returns search results.

get-status

Gets the current status of the Searchcraft service.

get-preliminary-search-data

Provides information about the configured search index, including facets and available schema fields.

Getting Started

Create .env file at project root, and fill in the values:

# Server Config
USER_AGENT=searchcraft-mcp-server/<project-version>
DEBUG=true
PORT=3100

# Searchcraft Config
ENDPOINT_URL=
INDEX_NAME=
READ_KEY=
INGEST_KEY=

.env sample

You will need a Searchcraft search index. Head to Vektron ↗︎, your command center for creating and configuring indexes, managing settings, and navigating all things Searchcraft.

Install dependencies with yarn

yarn

Start the server

yarn start

Use With Claude Desktop

Claude Desktop is an MCP client that we can connect our MCP server to. Since this is a node/express server, you must use mcp-remote to bridge it into Claude Desktop. We do this rather than use the stdio transport type. This allows more flexibility into where/how the server is hosted.

https://github.com/geelen/mcp-remote

In your claude_desktop_config.json file, located at /Users/[My Workspace]]/Library/Application Support/Claude/claude_desktop_config.json put the following:

{
  "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:<MY-PORT-FROM-ENV>/mcp"
      ]
    }
  }
}

Claude desktop config example

To view claude's logs for debugging purposes, use the npm script:

yarn claude-logs

Debugging

You can view and try out the available tools/prompts/resources using the inspector. While the mcp server is running, you can launch the inspector:

yarn inspect

• Choose Transport Type: Streamable HTTP
• Specify the URL that the server is running on, including the port number.
• Hit "Connect"

http://localhost:<MY-PORT-FROM-ENV>/mcp

The Inspector allows you to view available tools and to try making test calls to them.

Resources

• 📘 Searchcraft Docs
• 🛰️ Vektron Dashboard
• 💬 Searchcraft Discord
• 🧪 Searchcraft SDK on npm

License

Licensed under the Apache 2.0 License.

<p align="center"> Built with 🛰️ by the <a href="https://searchcraft.io">Searchcraft</a> team </p>