Data Intelligence MCP Server

数据智能MCP服务器

IBM数据智能MCP服务器提供了模型上下文协议（MCP）的模块化和可扩展实现，专门用于与IBM数据智能服务集成。它实现了MCP客户端和IBM数据智能功能之间的安全和可扩展交互。

有关此版本支持的工具列表和示例提示，请参阅 工具\_ PROMPTS.md

flowchart LR
    github["data-intelligence-mcp Github"] -- publish --> registry
    registry["PyPi registry"] -- pip install ibm-watsonx-data-intelligence-mcp-server--> server
    subgraph MCP Host
        client["MCP Client"]  server("Data Intelligence MCP Server")
    end
    server -- HTTPS --> runtime("IBM Data Intelligence")
    subgraph id["Services"]
        runtime
    end
    client  server2("Data Intelligence MCP Server") -- HTTPS --> runtime

资源：

• 将Claude与Watsonx数据智能集成 演示Claude Desktop如何连接到数据智能MCP服务器的分步指南。
• Watsonx Orchestrate+数据智能 演示Watsonx Orchestrate如何与MCP服务器集成以实现自动化。
• Ibm Bob+数据智能 一个分步指南，显示IBM Bob如何连接到数据智能MCP服务器。

______________________________________________________________________

目录

1. 快速安装-PyPI

- 先决条件 - 安装

1. 快速安装-uvx

- 先决条件 - 安装

1. 服务器

- HTTP模式 - HTTPS模式

1. 客户端配置

- 克劳德桌面 - stdio（建议用于本地设置） - http/https（远程设置） - VS代码副本 - stdio（建议用于本地设置） - http/https（远程设置） - 沃森管弦乐队 - IBM Bob

1. 配置

- 客户端设置 - SSL/TLS配置

______________________________________________________________________

快速安装-PyPI

先决条件

• Python 3.11或更高版本
• 数据智能SaaS或CPD 5.2.1

安装

标准安装

使用pip/pip3进行标准安装：

pip install ibm-watsonx-data-intelligence-mcp-server

______________________________________________________________________

快速安装并运行-uv

先决条件

• 紫外线 安装指南
• 数据智能SaaS或CPD 5.2.1

安装并运行

stdio模式

uvx ibm-watsonx-data-intelligence-mcp-server --transport stdio

http模式

uvx ibm-watsonx-data-intelligence-mcp-server

______________________________________________________________________

服务器

如果您已在主机上本地安装了ibmwatsonx数据智能mcp服务器，并希望从Claude、Copilot或LMStudio等客户端连接，则可以使用stdio模式，如以下示例所述 客户端配置 部分。

服务器也可以在http/https模式下配置和运行。

参见 客户端设置 http模式的适用环境变量部分。在启动下面的服务器之前，请根据需要进行更新。默认DI_ENV_MODE为SaaS

HTTP模式

ibm-watsonx-data-intelligence-mcp-server --transport http --host 0.0.0.0 --port 3000

HTTPS模式

参见 SERVER_HTTPS.md 了解详细的HTTPS服务器配置和设置。

stdio模式

在中通过Claude、Copilot或MCP客户端配置服务器时 stdio模式，服务器不需要单独启动。客户端将使用标准输入/输出直接调用服务器。

______________________________________________________________________

客户端配置

克劳德桌面

stdio（建议用于本地mcp服务器设置）

前提条件：紫外线 安装指南

将MCP服务器添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "wxdi-mcp-server": {
      "command": "uvx",
      "args": ["ibm-watsonx-data-intelligence-mcp-server", "--transport", "stdio"],
      "env": {
         "DI_SERVICE_URL": "https://api.dataplatform.cloud.ibm.com",
         "DI_APIKEY": "",
         "DI_ENV_MODE": "SaaS",
         "LOG_FILE_PATH": "/tmp/di-mcp-server-logs"
      }
    }
  }
}

http/https（远程设置）

如果MCP服务器在本地/远程服务器上以http/https模式运行。

对于云SaaS：

{
  "mcpServers": {
    "wxdi-mcp-server": {
      "url": "",
      "type": "http",
      "headers": {
        "x-api-key": "your api key from cloud SaaS"
      }
    }
  }
}

对于CPD：

{
  "mcpServers": {
    "wxdi-mcp-server": {
      "url": "",
      "type": "http",
      "headers": {
        "x-api-key": "your api key from cpd env",
        "username": ""
      }
    }
  }
}

VS代码副本

stdio（建议用于本地mcp服务器设置）

前提条件：紫外线 安装指南

将MCP服务器添加到您的VS Code Copilot MCP配置中：

{
  "servers": {
    "wxdi-mcp-server": {
      "command": "uvx",
      "args": ["ibm-watsonx-data-intelligence-mcp-server", "--transport", "stdio"],
      "env": {
         "DI_SERVICE_URL": "https://api.dataplatform.cloud.ibm.com",
         "DI_APIKEY": "",
         "DI_ENV_MODE": "SaaS",
         "LOG_FILE_PATH": "/tmp/di-mcp-server-logs"
      }
    }
  }
}

http/https（远程设置）

如果MCP服务器在本地/远程服务器上以http/https模式运行。

对于云SaaS：

{
  "servers": {
    "wxdi-mcp-server": {
      "url": "",
      "type": "http",
      "headers": {
        "x-api-key": "your api key from cloud SaaS"
      }
    }
  }
}

对于CPD：

{
  "servers": {
    "wxdi-mcp-server": {
      "url": "",
      "type": "http",
      "headers": {
        "x-api-key": "your api key for cpd env",
        "username": ""
      }
    }
  }
}

沃森管弦乐队

Watsonx Orchestrate+数据智能 这篇博客文章演示了Watsonx Orchestrate如何与MCP服务器集成以实现自动化。

IBM Bob

IBM Bob+数据智能 这篇博客文章演示了IBMBob如何和MCPServer集成以实现自动化。

______________________________________________________________________

配置

MCP服务器可以使用环境变量或 .env 文件。复制 .env.example 到 .env 并根据需要修改这些值。

客户端设置

以下客户端设置是常见的 http 或 stdio 模式

以下客户端设置仅适用于 stdio 模式

对于 http/https 模式客户端可以发送以下标头

例如：

{
  "servers": {
    "wxdi-mcp-server": {
      "url": "",
      "type": "http",
      "headers": {
        "x-api-key": "your api key from cloud SaaS/cpd"
      }
    }
  }
}

{
  "servers": {
    "wxdi-mcp-server": {
      "url": "",
      "type": "http",
      "headers": {
        "authorization": "Bearer token"
      }
    }
  }
}

SSL/TLS配置

若在CPD环境中运行，您可能需要为客户端连接配置SSL证书。请查看 SSL_证书_GUIDE.md 了解更多详情。