SearchUnify

Provides secure, context-aware enterprise search integration between SearchUnify and external apps via a Docker-based MCP server.

other

2

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "searchunify-su-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "<path_to_creds.json>:/app/src/input/creds.json:ro",
        "searchunifyutils/su-mcp"
      ]
    }
  }
}

You want to connect SearchUnify to external applications securely and with context-aware capabilities. This MCP server acts as a lightweight middleware that enables seamless, token-protected communication between SearchUnify and external clients like Claude Desktop, powered by the su-sdk-js toolkit. It focuses on enabling enterprise search with secure access and easy deployment through Docker.

How to use

Use the su-mcp server from your external application or client to fetch search results and power context-aware workflows within that environment. Configure your client to communicate with the MCP server using the supported startup command (via Docker) and provide the necessary credentials. Once running, your client can request enterprise search results from your SearchUnify instance, leveraging OAuth 2.0 security and the server’s integration with the external app.

How to install

Prerequisites you need before starting:

Install Docker on your machine.

Create credential files to authenticate with your SearchUnify instance. You will use either password, apiKey, or clientCredentials authentication depending on your setup.

Follow these concrete steps to configure and run su-mcp with Claude Desktop integration.

Configuration and run details

"su-mcp": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-v",
    "<path_to_creds.json>:/app/src/input/creds.json:ro",
    "searchunifyutils/su-mcp"
  ]
}

Troubleshooting

Docker Not Found: Ensure Docker is installed and added to your system’s PATH.

Invalid Credentials: Double-check values in creds.json.

Missing API Scopes: Make sure the client and user have the required search scopes enabled in your SearchUnify instance.

License

This project is licensed under the BSD 2-Clause License. See the LICENSE file for details.

Usage patterns for Claude Desktop

When Claude Desktop is configured with su-mcp, it can fetch search results from your SearchUnify instance through the MCP server. You will typically point Claude Desktop to the MCP via the docker-based command shown above and provide the creds.json path to enable secure, token-based access.