数据智能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服务器。
______________________________________________________________________
目录
- 克劳德桌面 - stdio（建议用于本地设置） - http/https（远程设置） - VS代码副本 - stdio（建议用于本地设置） - http/https（远程设置） - 沃森管弦乐队 - IBM Bob
______________________________________________________________________
快速安装-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 stdiohttp模式
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 3000HTTPS模式
参见 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 模式
| 环境变量 | 默认值 | 描述 |
|---|---|---|
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": "",
"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 了解更多详情。