STARWARCLOUD STARWAR.AI
返回市场
差异知识MCP服务器

差异知识MCP服务器

作者：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 结合语义和全文搜索的混合模式

重新排序

重新排序

重新排列

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

  1. 故障排除

    • 常见问题
    • "请配置 DIFY_API_URL 和 DIFY_API_KEY"

  2. 确保 API URL 和 API 密钥配置正确

    • 检查数据集 ID 是否正确
    • "无法从 Dify 获取知识"
    • 检查 API 密钥是否有效

  3. 确认数据集 ID 存在

    • 验证网络连接
    • 连接超时

检查网络连接

确认 Dify API 服务是否可访问

# 测试配置状态
node index.js

测试配置

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

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

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

使用新的配置方法

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

Node.js 版本

：支持 ES 模块版本