searchcraft-mcp-server

An MCP Server powered by Searchcraft – the developer-first vertical search engine.

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

| Tool | Description | |------|-------------| | get_search_results | Performs search queries on the search index provided. It allows for complex queries based on fuzzy + exact keyword matching, date ranges, and facets. | | get_search_index_schema | Retrieves the current search index schema, including schema fields and facet information. Gives the MCP Client additional context about how to construct search queries. | | get_searchcraft_status | Performs a basic health check api request to the Searchcraft service. |

Getting Started

Environment Variables

Create .env file at the project's 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.

Running the Server

Install dependencies with yarn

yarn

Build & Start the server

yarn build
yarn start

Usage With Claude Desktop

The server must be running in order for Claude Desktop to detect searchcraft-mcp-server's tools.

searchcraft-mcp-server uses StreamableHTTPServerTransport, so in order to connect it to Claude Desktop, we use mcp-remote ↗︎.

In your claude desktop config file, add the following:

claude_desktop_config.json

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

The claude desktop config file can be found at /Users/[My Workspace]]/Library/Application Support/Claude/claude_desktop_config.json. If no file exists here you can create it.

Claude desktop config example

Debugging

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

yarn claude-logs

Inspector Tool

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 Reddit
• 🧪 Searchcraft SDK on npm

License

Licensed under the Apache 2.0 License.

Built with 🛰️ by the Searchcraft team