Dify Doc MCP Server

一个用于集成Dify知识库的MCP (Model Context Protocol) Server，允许AI助手直接访问和检索Dify知识库中的内容。

技术选型

• 语言: TypeScript
• 运行环境: Node.js v18+
• MCP框架: @modelcontextprotocol/sdk
• HTTP客户端: axios
• 数据验证: zod
• 传输方式: StdioServerTransport (标准输入输出)

主要架构

本项目实现了三个核心工具：

1. dify_retrieve_knowledge - 知识库检索
2. dify_list_datasets - 获取知识库列表
3. dify_get_dataset_detail - 获取知识库详情

通过MCP协议与Dify REST API集成，支持语义检索、关键字检索、全文检索和混合检索等多种检索方式。

安装

全局安装

npm install -g dify-doc-mcp-server

或使用npx（无需安装）

npx dify-doc-mcp-server

快速开始

方式一：使用npx（推荐）

# 直接运行，无需安装
DIFY_BASE_URL="http://your-dify-host:8031" DIFY_API_KEY="your-api-key" npx dify-doc-mcp-server

方式二：本地开发

# 1. 克隆项目
git clone <repository-url>
cd difydocmcpserver

# 2. 安装依赖
npm install

# 3. 配置环境变量
export DIFY_BASE_URL="http://localhost:8031"
export DIFY_API_KEY="your-dify-api-key"

# 4. 构建和运行
npm run build
npm start

可用工具

dify_list_datasets

获取Dify知识库列表

• keyword (可选): 搜索关键词
• limit (可选): 返回条数 (1-100，默认20)

dify_get_dataset_detail

获取Dify知识库详细信息

• dataset_id (必需): 知识库ID

dify_retrieve_knowledge

从Dify知识库中检索相关内容

• dataset_id (必需): 知识库ID
• query (必需): 检索查询内容
• search_method (可选): 检索方法 (semantic_search/keyword_search/full_text_search/hybrid_search)
• top_k (可选): 返回结果数量 (1-20，默认3)
• score_threshold (可选): 相似度阈值 (0-1，默认0)

MCP客户端配置

{
  "mcpServers": {
    "dify-doc": {
      "command": "npx",
      "args": ["dify-doc-mcp-server"],
      "env": {
        "DIFY_BASE_URL": "http://your-dify-host:8031",
        "DIFY_API_KEY": "your-dify-api-key"
      }
    }
  }
}

API密钥获取

1. 登录Dify控制台
2. 进入"设置" → "知识库" → "API" → "API密钥"
3. 创建新的API密钥
4. 复制密钥并设置到环境变量中

测试

# 设置环境变量并运行测试
DIFY_BASE_URL="http://your-dify-host:8031" DIFY_API_KEY="your-api-key" DATASET="your-dataset-name" QUERY="引导" node test-mcp.js

测试脚本会验证：

• MCP Server连接
• 工具列表获取
• 知识库列表、详情和检索功能

相关链接

• Dify官方文档
• MCP协议规范
• MCP TypeScript SDK