bd-acw-rag-mcp

一个用于 ACW RAG（检索增强生成）服务的 MCP（Model Context Protocol）服务器，支持知识库同步和智能检索。

功能特性

• 🔄 知识库同步：将知识库内容同步到 RAG 服务
• 🔍 智能检索：支持混合搜索、语义搜索、全文搜索
• 🎯 重排序：使用 Rerank 算法优化检索结果
• 🚀 即插即用：完美集成 Cursor IDE 和其他支持 MCP 的应用

安装

npm install -g bd-acw-rag-mcp

在 Cursor 中使用

1. 配置 MCP

在 Cursor 中，打开 MCP 配置文件（通常在 ~/.cursor/mcp.json），添加以下配置：

{
  "mcpServers": {
    "acw-mcp": {
      "command": "bd-acw-rag-mcp",
      "args": [],
      "env": {}
    }
  }
}

2. 重启 Cursor

配置完成后，重启 Cursor IDE，MCP 工具将自动加载。

3. 使用工具

在 Cursor 中，你可以直接调用以下 MCP 工具：

同步知识库

从 RAG 同步知识库

检索信息

从 RAG 搜索 [你的查询内容]

例如：

从 RAG 搜索 tinyboot redis 使用文档

MCP 工具说明

acw_sync

同步知识库到 RAG 服务。

参数：无

返回：同步结果，包含 collectionName 和 uuid

acw_query

从 RAG 服务检索信息。

参数：

• query (string, 必填)：检索查询内容
• searchMethod (string, 可选)：搜索方法，可选值：
  • hybrid_search（默认）：混合搜索
  • semantic_search：语义搜索
  • full_text_search：全文搜索
• topk (number, 可选)：返回结果数量，默认 5
• threshold (number, 可选)：相似度阈值，默认 0.1
• useRerank (boolean, 可选)：是否使用重排序，默认 true

返回：检索结果列表，包含匹配内容、相似度评分、来源等信息

直接运行（开发调试）

# 克隆项目
git clone https://github.com/yourusername/bd-acw-rag-mcp.git
cd bd-acw-rag-mcp

# 安装依赖
npm install

# 运行服务
npm run start:stdio

技术栈

• Node.js 18+
• @modelcontextprotocol/sdk - MCP 协议实现
• zod - 参数验证
• node-fetch - HTTP 请求

工作原理

1. STDIO 通信：MCP 服务器通过 STDIO（标准输入/输出）与 Cursor 通信
2. 工具注册：注册 acw_sync 和 acw_query 两个工具
3. RAG 服务：后端连接到 ACW RAG 服务进行知识库管理和检索

注意事项

• ⚠️ 本工具连接到内部 RAG 服务 (acw-fn.leo.bangdao-tech.com)
• ⚠️ 确保网络可以访问该服务地址
• ⚠️ Node.js 版本需要 >= 18.0.0

许可证

MIT

作者

manyue

贡献

欢迎提交 Issue 和 Pull Request！

更新日志

1.0.0 (2025-10-15)

• 🎉 初始版本发布
• ✅ 支持知识库同步
• ✅ 支持智能检索
• ✅ 集成 Cursor IDE