Watson Discovery

🚀 Watson Discovery MCP Server

A Model Context Protocol (MCP) server that enables secure interaction with Watson Discovery. This server allows AI assistants to list projects, list collections within projects, and execute queries through natural language processing.

🚀 Quick Start

The Watson Discovery MCP Server is designed to support secure interactions with Watson Discovery. It allows AI assistants to perform operations such as listing projects, collections, and executing NLP queries.

✨ Features

• List available projects.
• List available collections within a project.
• Execute queries in NLP.

📦 Installation

Set the following environment variables:

WATSONX_DISCOVERY_APIKEY=
WATSONX_DISCOVERY_URL=
WATSONX_DISCOVERY_VERSION=2023-03-31

💻 Usage Examples

Use in Claude Desktop

Add the following content to your claude_desktop_config.json file:

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

Run as an Independent Server

# Install dependencies
uv install 

# Run the server
uv run main.py

🔧 Technical Details

Development

# Clone the repository
git clone https://github.com/matlock08/watson_discovery_mcp.git
cd watson_discovery_mcp

# Create a virtual environment
uv venv 
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install development dependencies
uv install

# Run the server
uv run main.py

⚠️ Important Note

• Never commit environment variables or credentials.
• Use a database user with minimal privileges.
• Consider implementing a query whitelist in a production environment.
• Monitor and log all database operations.

📄 License

This project is under the MIT License - see the LICENSE file for details.