数据智能MCP服务器

Name: 数据智能MCP服务器
Author: IBM

作者：IBM8 星标更新：2025-11-14

安装使用来源：spider==github.com

项目介绍

数据智能MCP服务器

IBM数据智能MCP服务器提供了一个模块化和可扩展的Model Context Protocol (MCP)实现，专门设计用于与IBM数据智能服务集成。它使MCP客户端与IBM的数据智能能力之间能够进行安全且可扩展的交互。

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

flowchart LR
    github["data-intelligence-mcp Github"] -- 发布 --> registry
    registry["PyPi注册表"] -- pip install ibm-watsonx-data-intelligence-mcp-server --> server
    subgraph MCP主机
        客户端["MCP客户端"] <-- MCP/STDIO --> 服务器("数据智能MCP服务器")
    end
    服务器 -- HTTPS --> 运行时("IBM数据智能")
    subgraph 服务["Services"]
        运行时
    end
    客户端 <-- MCP/HTTP --> 服务器2("数据智能MCP服务器") -- HTTPS --> 运行时

资源：

将Claude与Watsonx数据智能集成步骤指南，展示Claude桌面如何连接到数据智能MCP服务器。
Watsonx编排+数据智能展示了Watsonx编排如何与MCP服务器集成以实现自动化。
IBM Bob+数据智能步骤指南，展示了IBM Bob如何连接到数据智能MCP服务器。

快速安装-PyPI

先决条件

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

安装

标准安装

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

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

快速安装和运行-uv

先决条件

uv 安装指南
数据智能SaaS或CPD 5.2.1

安装和运行

stdio模式

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

http模式

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

服务器

如果您已经在主机机器上本地安装了ibm-watsonx-data-intelligence-mcp-server，并希望从诸如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模式下配置服务器时，无需单独启动服务器。客户端将直接使用标准输入/输出调用服务器。

客户端配置

Claude桌面

stdio（推荐用于本地mcp服务器设置）

先决条件：uv 安装指南

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

{
  "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": "<数据智能API密钥>",
         "DI_ENV_MODE": "SaaS",
         "LOG_FILE_PATH": "/tmp/di-mcp-server-logs"
      }
    }
  }
}

http/https（远程设置）

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

对于云SaaS：

{
  "mcpServers": {
    "wxdi-mcp-server": {
      "url": "<mcp服务器的url>",
      "type": "http",
      "headers": {
        "x-api-key": "来自云SaaS的api密钥"
      }
    }
  }
}

对于CPD：

{
  "mcpServers": {
    "wxdi-mcp-server": {
      "url": "<mcp服务器的url>",
      "type": "http",
      "headers": {
        "x-api-key": "来自cpd环境的api密钥",
        "username": "<来自cpd环境的用户名>"
      }
    }
  }
}

VS Code Copilot

stdio（推荐用于本地mcp服务器设置）

先决条件：uv 安装指南

将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": "<数据智能API密钥>",
         "DI_ENV_MODE": "SaaS",
         "LOG_FILE_PATH": "/tmp/di-mcp-server-logs"
      }
    }
  }
}

http/https（远程设置）

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

对于云SaaS：

{
  "servers": {
    "wxdi-mcp-server": {
      "url": "<mcp服务器的url>",
      "type": "http",
      "headers": {
        "x-api-key": "来自云SaaS的api密钥"
      }
    }
  }
}

对于CPD：

{
  "servers": {
    "wxdi-mcp-server": {
      "url": "<mcp服务器的url>",
      "type": "http",
      "headers": {
        "x-api-key": "用于cpd环境的api密钥",
        "username": "<来自cpd环境的用户名>"
      }
    }
  }
}

Watsonx编排

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

IBM Bob

IBM Bob+数据智能博客文章展示了IBM Bob如何与MCP服务器集成以实现自动化。

配置

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

客户端设置

以下客户端设置无论http还是stdio模式都是通用的

环境变量	默认值	描述
`DI_SERVICE_URL`	`无`	Watsonx数据智能实例的基本URL。例如：SaaS为api.dataplatform.cloud.ibm.com，CPD为集群URL
`DI_ENV_MODE`	`SaaS`	环境模式（`SaaS`或`CPD`）
`REQUEST_TIMEOUT_S`	`60`	HTTP请求超时时间（秒）
`LOG_FILE_PATH`	`无`	如果提供，日志将写入此处。对于`stdio`模式是强制性的
`DI_CONTEXT`	`df`	工具响应返回的URL上下文（`df`，`cpdaas`用于DI_ENV_MODE=SaaS；`df`，`cpd`用于DI_ENV_MODE=CPD）。url将根据参数相应地追加。例如，在url中`context=df`

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

环境变量	默认值	描述
`DI_APIKEY`	`无`	认证使用的API密钥
`DI_USERNAME`	`无`	用户名（当使用API密钥访问CPD时需要）
`DI_AUTH_TOKEN`	`无`	作为API密钥替代的Bearer令牌

对于http/https模式，客户端可以发送以下头部信息

头部	默认值	描述
`x-api-key`	`无`	与SaaS/CPD相关的API密钥
`username`	`无`	当提供API密钥时的CPD环境用户名
`authorization`	`无`	作为API密钥替代的Bearer令牌

例如：

{
  "servers": {
    "wxdi-mcp-server": {
      "url": "<mcp服务器的url>",
      "type": "http",
      "headers": {
        "x-api-key": "来自云SaaS/cpd的api密钥"
      }
    }
  }
}

{
  "servers": {
    "wxdi-mcp-server": {
      "url": "<mcp服务器的url>",
      "type": "http",
      "headers": {
        "authorization": "Bearer令牌"
      }
    }
  }
}

SSL/TLS配置

如果在CPD环境中运行，您可能需要为客户端连接配置SSL证书。请查阅SSL_CERTIFICATE_GUIDE.md获取更多详情。

数据智能MCP服务器

项目介绍

数据智能MCP服务器

目录

快速安装-PyPI

先决条件

安装

标准安装

快速安装和运行-uv

先决条件

安装和运行

服务器

HTTP模式

HTTPS模式

stdio模式

客户端配置

Claude桌面

stdio（推荐用于本地mcp服务器设置）

http/https（远程设置）

VS Code Copilot

stdio（推荐用于本地mcp服务器设置）

http/https（远程设置）

Watsonx编排

IBM Bob

配置

客户端设置

SSL/TLS配置