差异知识MCP服务器

Name: 差异知识MCP服务器
Author: liiklin

作者：liiklin2 星标更新：2025-07-05

安装使用来源：spider==github.com

项目介绍

技术文档摘要

Dify 知识 MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器，用于访问 Dify 知识库。它允许 AI 助手（如光标）直接查询您的 Dify 知识库内容。

特性

🔍 查询 Dify 知识库内容
📊 支持多种搜索方式（语义搜索、全文搜索、混合搜索）
🎯 支持结果重新排序
⚙️ 灵活的配置选项
🛠️ 标准 MCP 协议支持

安全警告

⚠️ 重要：保护您的 API 密钥

不要在代码中硬编码 API 密钥
不要提交包含敏感信息的 .env 文件到版本控制
使用 .env 文件或环境变量存储敏感配置
定期更新您的 API 密钥

快速开始

1. 安装依赖

npm install

2. 配置 API 信息

您需要提供两个重要的信息：

数据集 ID 您的 Dify 知识库 ID
API 密钥 您的 Dify API 密钥

3. 配置 API 密钥

方法 1：使用 .env 文件（推荐）

# 复制配置模板
cp env.example .env

# 编辑 .env 文件，填入您的真实配置
# DIFY_API_URL=https://api.dify.ai/v1/datasets/YOUR_DATASET_ID/documents/query
# DIFY_API_KEY=your_actual_api_key

方法 2：环境变量

# Linux/Mac
export DIFY_API_URL="https://api.dify.ai/v1/datasets/YOUR_DATASET_ID/documents/query"
export DIFY_API_KEY="your_actual_api_key"

# Windows
set DIFY_API_URL=https://api.dify.ai/v1/datasets/YOUR_DATASET_ID/documents/query
set DIFY_API_KEY=your_actual_api_key

方法 3：命令行参数

node index.js --api-url="https://api.dify.ai/v1/datasets/YOUR_DATASET_ID/documents/query" --api-key="your_actual_api_key"

4. 运行服务器

node index.js

在光标中使用

1. 配置 MCP 服务器

在光标中，您需要配置 MCP 服务器。创建或编辑您的 MCP 配置文件：

{
  "mcpServers": {
    "dify-knowledge": {
      "command": "node",
      "args": [
        "/path/to/your/dify-knowledge-mcp-server/index.js"
      ],
      "env": {
        "DIFY_API_URL": "https://api.dify.ai/v1/datasets/YOUR_DATASET_ID/documents/query",
        "DIFY_API_KEY": "your_actual_api_key"
      }
    }
  }
}

注意： 替换上述占位符为您实际的值：

YOUR_DATASET_ID 您的 Dify 知识库 ID
your_actual_api_key 您的 Dify API 密钥
/path/to/your/dify-knowledge-mcp-server/index.js 您的项目路径

2. 可用工具函数

配置完成后，光标可以使用以下工具：

`query_dify_knowledge`

查询 Dify 知识库内容

参数：

query（必填）：搜索查询词
top_k（可选）：返回结果的数量，默认为 3
search_method（可选）：搜索方法，可选值：
- semantic_search：语义搜索
- full_text_search：全文搜索
- hybrid_search：混合搜索（默认）
reranking_enable（可选）：启用重新排序，默认为 true

示例：

请查询关于"产品介绍"的相关内容

`get_dify_config`

检查当前 Dify API 配置状态

使用示例

光标中的对话示例

用户: 请帮我查询知识库中关于"用户手册"的内容

AI助手: 我来为你查询Dify知识库中关于"用户手册"的内容...
[调用query_dify_knowledge工具]

找到了3个相关的知识条目：

1. (得分: 0.95)
用户手册第一章介绍了产品的基本功能和使用方法...

2. (得分: 0.87)
用户手册第二章详细说明了高级功能的配置步骤...

3. (得分: 0.82)
用户手册常见问题解答部分提供了问题解决方案...

配置说明

API URL 格式

https://api.dify.ai/v1/datasets/{dataset_id}/documents/query

支持的搜索方法

semantic_search 基于语义理解的搜索
full_text_search 传统的全文搜索
hybrid_search 结合语义和全文搜索的混合模式

重新排序

重新排列

启用重新排序可以提高搜索结果的相关性，但可能会增加响应时间。

故障排除
- 常见问题
- "请配置 DIFY_API_URL 和 DIFY_API_KEY"
确保 API URL 和 API 密钥配置正确
- 检查数据集 ID 是否正确
- "无法从 Dify 获取知识"
- 检查 API 密钥是否有效
确认数据集 ID 存在
- 验证网络连接
- 连接超时

检查网络连接

确认 Dify API 服务是否可访问

# 测试配置状态
node index.js

测试配置

运行以下命令以测试配置：

如果您看到消息“准备查询知识库！”，则表示配置正确。

清理敏感信息 如果您之前在配置文件中暴露了 API 密钥，请立即更新：~/.cursor/mcp.json 光标配置文件
（通常在
或类似路径中） 删除或替换暴露的 API 密钥
检查版本控制历史记录 确保没有提交任何敏感信息

使用新的配置方法

通过 .env 文件或环境变量 开发信息
协议：模型上下文协议（MCP）
传输方式：标准 I/O
API 版本：Dify API v1

Node.js 版本

：支持 ES 模块版本