AI导哈

数据智能MCP服务器

IBM数据智能MCP服务器是一个模块化、可扩展的模型上下文协议（MCP）实现，专为与IBM数据智能服务集成而设计，支持MCP客户端与IBM数据智能能力的安全、可扩展交互。

  • by hingaibm
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hingaibm/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"] <-- MCP/STDIO --> server("Data Intelligence MCP Server")
    end
    server -- HTTPS --> runtime("IBM Data Intelligence")
    subgraph id["Services"]
        runtime
    end
    client <-- MCP/HTTP --> server2("Data Intelligence MCP Server") -- HTTPS --> runtime

资源：

目录

  1. 快速安装-PyPI
  2. 快速安装-uvx
  3. 服务器
  4. 客户端配置
  5. 配置

快速安装-PyPI

先决条件

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

安装

标准安装

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

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

快速安装并运行-uv

先决条件

安装并运行

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": "<data intelligence api key>",
         "DI_ENV_MODE": "SaaS",
         "LOG_FILE_PATH": "/tmp/di-mcp-server-logs"
      }
    }
  }
}

http/https（远程设置）

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

对于云SaaS：

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

对于CPD：

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

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": "<data intelligence api key>",
         "DI_ENV_MODE": "SaaS",
         "LOG_FILE_PATH": "/tmp/di-mcp-server-logs"
      }
    }
  }
}

http/https（远程设置）

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

对于云SaaS：

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

对于CPD：

{
  "servers": {
    "wxdi-mcp-server": {
      "url": "<url_to_mcp_server>",
      "type": "http",
      "headers": {
        "x-api-key": "your api key for cpd env",
        "username": "<user name from cpd env>"
      }
    }
  }
}

沃森管弦乐队

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

IBM Bob

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

配置

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

客户端设置

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

环境变量 默认值 描述
DI_SERVICE_URL None Watsonx数据智能实例的基本URL。示例：api.dataplatform.cloud.ibm.com用于SaaS，集群url用于CPD
DI_ENV_MODE SaaS 环境模式(SaaS 或 CPD)
REQUEST_TIMEOUT_S 60 HTTP请求超时（秒）
LOG_FILE_PATH None 如果提供，日志将写在这里。强制要求 stdio 模式
DI_CONTEXT df 从工具响应返回的URL的上下文( df, cpdaas 对于DI_ENV_MODE=SaaS； df, cpd 对于DI_ENV_MODE=CPD）。url将相应地附加查询参数。context=df 例如，在url中

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

环境变量 默认值 描述
DI_APIKEY None 用于身份验证的API密钥
DI_USERNAME None 用户名（使用API密钥进行CPD时需要）
DI_AUTH_TOKEN None API密钥替代方案的承载令牌

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

标题 默认值 描述
x-api-key None 与SaaS/CPD相关的API密钥
username None CPD env的用户名如果提供了API密钥
authorization None apikey的不记名代币替代品

例如：

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

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

SSL/TLS配置

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

相关 MCP