Provides configuration management for API keys and URLs through .env files, ensuring sensitive credentials for Dify knowledge base access are stored securely
Runs the MCP server implementation, allowing Cursor AI to query Dify knowledge bases through a standardized interface
Manages dependencies for the MCP server, facilitating easy installation and setup of required packages
Dify Knowledge MCP Server
这是一个基于Model Context Protocol (MCP)的服务器,用于访问Dify知识库。它可以让AI助手(如Cursor)直接查询你的Dify知识库内容。
功能特性
- 🔍 查询Dify知识库内容
- 📊 支持多种搜索方法(语义搜索、全文搜索、混合搜索)
- 🎯 支持重新排序结果
- ⚙️ 灵活的配置选项
- 🛠️ 标准MCP协议支持
安全警告
⚠️ 重要:保护你的API密钥
- 永远不要在代码中硬编码API密钥
- 不要将包含敏感信息的.env文件提交到版本控制
- 使用.env文件或环境变量来存储敏感配置
- 定期更新你的API密钥
快速开始
1. 安装依赖
2. 配置API信息
你需要提供两个重要信息:
- Dataset ID: 你的Dify知识库ID
- API Key: 你的Dify API密钥
3. 配置API密钥
方式1:使用.env文件(推荐)
方式2:环境变量
方式3:命令行参数
4. 运行服务器
在Cursor中使用
1. 配置MCP服务器
在Cursor中,你需要配置MCP服务器。创建或编辑你的MCP配置文件:
注意: 替换上面的占位符为你的实际值:
YOUR_DATASET_ID
: 你的Dify知识库IDyour_actual_api_key
: 你的Dify API密钥/path/to/your/dify-knowledge-mcp-server/index.js
: 你的项目路径
2. 可用的工具函数
配置完成后,Cursor可以使用以下工具:
query_dify_knowledge
查询Dify知识库内容
参数:
query
(必需): 搜索查询词top_k
(可选): 返回结果数量,默认为3search_method
(可选): 搜索方法,可选值:semantic_search
: 语义搜索full_text_search
: 全文搜索hybrid_search
: 混合搜索(默认)
reranking_enable
(可选): 启用重新排序,默认为true
示例:
get_dify_config
检查当前Dify API配置状态
使用示例
在Cursor中的对话示例
配置说明
API URL格式
支持的搜索方法
- semantic_search: 基于语义理解的搜索
- full_text_search: 传统的全文搜索
- hybrid_search: 结合语义和全文搜索的混合模式
重新排序
启用重新排序可以提高搜索结果的相关性,但可能会增加响应时间。
故障排除
常见问题
- "Please configure DIFY_API_URL and DIFY_API_KEY"
- 确保API URL和API Key已正确配置
- 检查Dataset ID是否正确
- "Failed to retrieve knowledge from Dify"
- 检查API Key是否有效
- 确认Dataset ID是否存在
- 验证网络连接
- 连接超时
- 检查网络连接
- 确认Dify API服务是否可访问
测试配置
运行以下命令测试配置:
如果看到"Ready to query knowledge base!"消息,说明配置正确。
清理敏感信息
如果你之前在配置文件中暴露了API密钥,请立即:
- 更新Cursor配置文件 (通常在
~/.cursor/mcp.json
或类似路径) - 删除或更换暴露的API密钥
- 检查版本控制历史 确保没有提交敏感信息
- 使用新的配置方法 通过.env文件或环境变量
开发信息
- 协议: Model Context Protocol (MCP)
- 传输方式: Standard I/O
- API版本: Dify API v1
- Node.js版本: 支持ES模块的版本
许可证
ISC License
This server cannot be installed
A Model Context Protocol server that enables AI assistants like Cursor to directly query and retrieve information from Dify knowledge bases through natural language.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.Last updated -10Python
- -securityAlicense-qualityA Model Context Protocol server implementation that enables AI assistants to execute SQL queries and interact with SQLite databases through a structured interface.Last updated -6TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that enables Cursor AI assistants to interact with Todoist tasks directly from the coding environment, supporting advanced task filtering and rich formatting.Last updated -29Python
- -securityAlicense-qualityA Model Context Protocol server that provides AI assistants with comprehensive access to SQL databases, enabling schema inspection, query execution, and database operations with enterprise-grade security.Last updated -54TypeScriptMIT License