WatsonX Discovery

Provides an MCP server to interact with Watson Discovery for listing projects, collections, and NLP-driven queries.

python

GitHub Stars

python

Language

7 months ago

First Indexed

3 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": {
    "matlock08-watson_discovery_mcp": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "/home/morpheus/.local/bin/uv --directory /home/morpheus/workspace/mcp-discovery run 'server/__main__.py'"
      ],
      "env": {
        "WATSONX_DISCOVERY_URL": "https://your-watson-discovery-url.example.com",
        "WATSONX_DISCOVERY_APIKEY": "YOUR_API_KEY",
        "WATSONX_DISCOVERY_VERSION": "2023-03-31"
      }
    }
  }
}

The MCP Watson Discovery Server enables secure interaction with IBM Watson Discovery by exposing a server that can list projects, list collections within projects, and execute NLP-driven queries across those collections. This makes it easier for AI assistants to retrieve and reason over Watson Discovery data without exposing raw API calls to end users.

How to use

Use this MCP server from your MCP client to interact with Watson Discovery. You can list available projects, inspect collections within projects, and run NLP-driven queries across a chosen collection. The server authenticates with Watson Discovery using API credentials provided in the configuration environment and translates client requests into Watson Discovery API calls.

How to install

Prerequisites: Python and the UV tooling used by this MCP workflow. You should also have access to a Watson Discovery service with an API key, URL, and version as described in the configuration section.

uv install

Run the server locally using the standard UV command shown in the repository. This starts the MCP server that communicates with Watson Discovery.

uv run server/__main__.py

Additional configuration and usage notes

Configuration relies on environment variables for Watson Discovery authentication and endpoint details. The following variables must be set before running the MCP server:

WATSONX_DISCOVERY_APIKEY: Your Watson Discovery API key.
WATSONX_DISCOVERY_URL: The Watson Discovery service URL.
WATSONX_DISCOVERY_VERSION: The Watson Discovery API version (e.g., 2023-03-31).

The repository provides two practical ways to run the MCP server via a client configuration: a Claude Desktop setup that uses Windows Subsystem for Linux (WSL) to start the server, and a standalone local run with UV. Both approaches expect the same underlying Python entry point at server/__main__.py.

{
  "mcpServers": {
    "watsonx_discovery": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "/home/morpheus/.local/bin/uv --directory /home/morpheus/workspace/mcp-discovery run 'server/__main__.py'"
      ]
    }
  }
}

License and further development

This MCP server is provided under the MIT License. See the LICENSE file for details.

Built by

VeilStrat

AI signals for GTM teams