# 安装 IBM watsonx.ai Granite

- 类型: MCP 工具
- 说明: 通过 IBM watsonx.ai Granite 进行对话、文本生成、向量嵌入与分词处理。
- 仓库: https://github.com/nirholas/three.ws
- ⚠ 安全: 该 MCP 工具主要用于调用 IBM watsonx.ai 的聊天、生成与向量能力，已知需要多项敏感配置并会执行本地工具代码；基于官方 Registry、开源且近期维护，整体更接近需留意而非高风险。材料较少且未给出 README/明确端点细节，建议按最小权限配置并限制可用密钥范围。

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "IBM watsonx.ai Granite" MCP 服务：
执行：claude mcp add io-github-nirholas-ibm-watsonx -- npx -y @three-ws/ibm-watsonx-mcp
```

### Codex
```
请帮我安装 askskill 上的 "IBM watsonx.ai Granite" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-nirholas-ibm-watsonx]
command = "npx"
args = ["-y","@three-ws/ibm-watsonx-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "IBM watsonx.ai Granite" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-nirholas-ibm-watsonx": { "command": "npx", "args": ["-y","@three-ws/ibm-watsonx-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env WATSONX_API_KEY=YOUR_VALUE --env WATSONX_PROJECT_ID=YOUR_VALUE --env WATSONX_SPACE_ID=YOUR_VALUE --env WATSONX_URL=YOUR_VALUE --env WATSONX_MODEL_ID=YOUR_VALUE --env WATSONX_EMBED_MODEL_ID=YOUR_VALUE --env WATSONX_API_VERSION=YOUR_VALUE --transport stdio io-github-nirholas-ibm-watsonx -- npx -y @three-ws/ibm-watsonx-mcp
```
需要环境变量：WATSONX_API_KEY, WATSONX_PROJECT_ID, WATSONX_SPACE_ID, WATSONX_URL, WATSONX_MODEL_ID, WATSONX_EMBED_MODEL_ID, WATSONX_API_VERSION

### Codex
```bash
codex mcp add --env WATSONX_API_KEY=YOUR_VALUE --env WATSONX_PROJECT_ID=YOUR_VALUE --env WATSONX_SPACE_ID=YOUR_VALUE --env WATSONX_URL=YOUR_VALUE --env WATSONX_MODEL_ID=YOUR_VALUE --env WATSONX_EMBED_MODEL_ID=YOUR_VALUE --env WATSONX_API_VERSION=YOUR_VALUE io-github-nirholas-ibm-watsonx -- npx -y @three-ws/ibm-watsonx-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-nirholas-ibm-watsonx]
command = "npx"
args = ["-y","@three-ws/ibm-watsonx-mcp"]

[mcp_servers.io-github-nirholas-ibm-watsonx.env]
WATSONX_API_KEY = "YOUR_VALUE"
WATSONX_PROJECT_ID = "YOUR_VALUE"
WATSONX_SPACE_ID = "YOUR_VALUE"
WATSONX_URL = "YOUR_VALUE"
WATSONX_MODEL_ID = "YOUR_VALUE"
WATSONX_EMBED_MODEL_ID = "YOUR_VALUE"
WATSONX_API_VERSION = "YOUR_VALUE"
```
需要环境变量：WATSONX_API_KEY, WATSONX_PROJECT_ID, WATSONX_SPACE_ID, WATSONX_URL, WATSONX_MODEL_ID, WATSONX_EMBED_MODEL_ID, WATSONX_API_VERSION

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-nirholas-ibm-watsonx": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-watsonx-mcp"
      ],
      "env": {
        "WATSONX_API_KEY": "YOUR_VALUE",
        "WATSONX_PROJECT_ID": "YOUR_VALUE",
        "WATSONX_SPACE_ID": "YOUR_VALUE",
        "WATSONX_URL": "YOUR_VALUE",
        "WATSONX_MODEL_ID": "YOUR_VALUE",
        "WATSONX_EMBED_MODEL_ID": "YOUR_VALUE",
        "WATSONX_API_VERSION": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-nirholas-ibm-watsonx&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0aHJlZS13cy9pYm0td2F0c29ueC1tY3AiXSwiZW52Ijp7IldBVFNPTlhfQVBJX0tFWSI6IllPVVJfVkFMVUUiLCJXQVRTT05YX1BST0pFQ1RfSUQiOiJZT1VSX1ZBTFVFIiwiV0FUU09OWF9TUEFDRV9JRCI6IllPVVJfVkFMVUUiLCJXQVRTT05YX1VSTCI6IllPVVJfVkFMVUUiLCJXQVRTT05YX01PREVMX0lEIjoiWU9VUl9WQUxVRSIsIldBVFNPTlhfRU1CRURfTU9ERUxfSUQiOiJZT1VSX1ZBTFVFIiwiV0FUU09OWF9BUElfVkVSU0lPTiI6IllPVVJfVkFMVUUifX0
需要环境变量：WATSONX_API_KEY, WATSONX_PROJECT_ID, WATSONX_SPACE_ID, WATSONX_URL, WATSONX_MODEL_ID, WATSONX_EMBED_MODEL_ID, WATSONX_API_VERSION