# 快速開始
## 1. 安裝
```bash
npm install -g @funtuantw/dify-external-knowledge-mcp
```
或使用 npx 直接運行（推薦）。
## 2. 配置環境變數
複製 `.env.example` 為 `.env` 並填入您的設定：
```bash
cp .env.example .env
```
編輯 `.env` 文件：
```env
DIFY_KNOWLEDGE_ENDPOINT=https://your-endpoint.com
DIFY_API_KEY=your-api-key-here
DIFY_KNOWLEDGE_ID=your-knowledge-id-here
```
## 3. 測試運行
```bash
npm run dev
```
## 4. 配置到 MCP 客戶端
在 Claude Desktop 的配置文件中添加（macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`）：
```json
{
"mcpServers": {
"dify-knowledge": {
"command": "npx",
"args": ["@funtuantw/dify-external-knowledge-mcp"],
"env": {
"DIFY_KNOWLEDGE_ENDPOINT": "https://your-endpoint.com",
"DIFY_API_KEY": "your-api-key-here",
"DIFY_KNOWLEDGE_ID": "your-knowledge-id-here"
}
}
}
}
```
或使用本地路徑（開發時）：
```json
{
"mcpServers": {
"dify-knowledge": {
"command": "node",
"args": [
"/Users/chenbaihan/node-project/dify-external-knowledge-mcp/dist/index.js",
"--endpoint",
"https://your-endpoint.com",
"--api-key",
"your-api-key-here",
"--knowledge-id",
"your-knowledge-id-here"
]
}
}
}
```
## 5. 使用示例
重啟 Claude Desktop 後，可以這樣使用：
```
請使用 query_dify_knowledge 工具查詢 "什麼是 Dify？"
```
工具會自動使用環境變數中配置的知識庫 ID，您不需要每次都指定。
## 主要變更
- ✅ 修正了過時的 MCP SDK API（使用 `McpServer` 替代 `Server`）
- ✅ `knowledge_id` 現在從環境變數讀取，不需要在每次查詢時提供
- ✅ 簡化了工具調用，只需提供查詢內容即可
- ✅ **新增支援命令列參數配置** - 可使用 `--endpoint`、`--api-key`、`--knowledge-id` 參數
- ✅ 命令列參數優先級高於環境變數，提供更靈活的配置方式
