{"_id":"@byo-cwc/enterprise-kb-mcp","_rev":"3-39ce9194f14ff700186bf25544d5330a","name":"@byo-cwc/enterprise-kb-mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@byo-cwc/enterprise-kb-mcp","version":"1.0.0","keywords":["mcp","ragflow","knowledge-base","enterprise","claude"],"author":{"name":"BYO"},"license":"MIT","_id":"@byo-cwc/enterprise-kb-mcp@1.0.0","maintainers":[{"name":"cwc123456","email":"chenwenchao@byosoft.com.cn"}],"homepage":"https://github.com/ssssss1d/ragflow-mcp-marketplace#readme","bugs":{"url":"https://github.com/ssssss1d/ragflow-mcp-marketplace/issues"},"bin":{"enterprise-kb-mcp":"run.mjs"},"dist":{"shasum":"efb9eb181186e9bb55ae094715490f9bd9f02dec","tarball":"https://registry.npmjs.org/@byo-cwc/enterprise-kb-mcp/-/enterprise-kb-mcp-1.0.0.tgz","fileCount":5,"integrity":"sha512-1mE9+PCwjPiBlKjSmoTqssnplQnh4aG/UCjPXYDNfN8z17ncEaxKQT2RLOGzVLrqLG6O5L2pZ09CLZvovVRx8g==","signatures":[{"sig":"MEQCIHF0C8zpqE3/ITe0WqAofvYAQIYEHuD5MTfkUiMJSEEHAiBIzF6YXSiPXAsW+vNHedxh06ST0HdxeowTeOlF+RBl/w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12064},"main":"mcp_server_npx.py","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node run.mjs"},"_npmUser":{"name":"cwc123456","email":"chenwenchao@byosoft.com.cn"},"repository":{"url":"git+https://github.com/ssssss1d/ragflow-mcp-marketplace.git","type":"git"},"_npmVersion":"10.8.2","description":"Enterprise Knowledge Base MCP Server for RAGFlow","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/enterprise-kb-mcp_1.0.0_1784270076946_0.1743501498270743","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@byo-cwc/enterprise-kb-mcp","version":"1.1.0","keywords":["mcp","ragflow","knowledge-base","enterprise","claude"],"author":{"name":"BYO"},"license":"MIT","_id":"@byo-cwc/enterprise-kb-mcp@1.1.0","maintainers":[{"name":"cwc123456","email":"chenwenchao@byosoft.com.cn"}],"homepage":"https://github.com/ssssss1d/ragflow-mcp-marketplace#readme","bugs":{"url":"https://github.com/ssssss1d/ragflow-mcp-marketplace/issues"},"bin":{"enterprise-kb-mcp":"run.mjs"},"dist":{"shasum":"8b72e833f4f7b7cd37d5e077975d0e5007cc229e","tarball":"https://registry.npmjs.org/@byo-cwc/enterprise-kb-mcp/-/enterprise-kb-mcp-1.1.0.tgz","fileCount":5,"integrity":"sha512-WS4dAaSE9E2cgBIJX2JU2UCUSpU5Uuo/lPEM/+XpJOZGaG2Q6MnGNs5v0pViDyl2sJUii8qUigaZxmLXerELMQ==","signatures":[{"sig":"MEUCIBiz9wmoxeIIGbX7mHo2AXpziQ0oH2a2NpNTK1ssrj2cAiEA5xyhoydAPAbT5TIr2H96hDwIoqjrh1aVY30zTm/bJaw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13426},"main":"mcp_server_npx.py","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node run.mjs"},"_npmUser":{"name":"cwc123456","email":"chenwenchao@byosoft.com.cn"},"repository":{"url":"git+https://github.com/ssssss1d/ragflow-mcp-marketplace.git","type":"git"},"_npmVersion":"10.8.2","description":"Enterprise Knowledge Base MCP Server for RAGFlow","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/enterprise-kb-mcp_1.1.0_1784270693669_0.8398512086734478","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@byo-cwc/enterprise-kb-mcp","version":"1.2.0","description":"Enterprise Knowledge Base MCP Server for RAGFlow (Cloud & Local)","main":"mcp_server_cloud.py","type":"module","bin":{"enterprise-kb-mcp":"run.mjs"},"scripts":{"start":"node run.mjs"},"keywords":["mcp","ragflow","knowledge-base","enterprise","claude"],"author":{"name":"BYO"},"license":"MIT","engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/ssssss1d/ragflow-mcp-marketplace.git"},"_id":"@byo-cwc/enterprise-kb-mcp@1.2.0","bugs":{"url":"https://github.com/ssssss1d/ragflow-mcp-marketplace/issues"},"homepage":"https://github.com/ssssss1d/ragflow-mcp-marketplace#readme","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-IHYBO2o3JeCNPWr3sCivMCcqkqxdFw0tEhcA0vfnDpGVD5WVh/2al6ZeQWF6VTuZwtLz+tpNJx3l34fU0N2ZtQ==","shasum":"dfc90d0ad9f47674798eaafcd9f81554b0a82b8d","tarball":"https://registry.npmjs.org/@byo-cwc/enterprise-kb-mcp/-/enterprise-kb-mcp-1.2.0.tgz","fileCount":6,"unpackedSize":17767,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCYd2CWMIH//ME4vZJv4UkP1+NBFGwGVcRCExvVYjVn9AIgR8rcemma8CrPAPElVv0S/FJT1buSakM+BefUAVLSqps="}]},"_npmUser":{"name":"cwc123456","email":"chenwenchao@byosoft.com.cn"},"directories":{},"maintainers":[{"name":"cwc123456","email":"chenwenchao@byosoft.com.cn"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/enterprise-kb-mcp_1.2.0_1784272202587_0.6522974169348721"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-17T06:34:36.857Z","modified":"2026-07-17T07:10:02.918Z","1.0.0":"2026-07-17T06:34:37.069Z","1.1.0":"2026-07-17T06:44:53.801Z","1.2.0":"2026-07-17T07:10:02.727Z"},"bugs":{"url":"https://github.com/ssssss1d/ragflow-mcp-marketplace/issues"},"author":{"name":"BYO"},"license":"MIT","homepage":"https://github.com/ssssss1d/ragflow-mcp-marketplace#readme","keywords":["mcp","ragflow","knowledge-base","enterprise","claude"],"repository":{"type":"git","url":"git+https://github.com/ssssss1d/ragflow-mcp-marketplace.git"},"description":"Enterprise Knowledge Base MCP Server for RAGFlow (Cloud & Local)","maintainers":[{"name":"cwc123456","email":"chenwenchao@byosoft.com.cn"}],"readme":"# RAGFlow MCP Server\n\n企业知识库问答服务，通过 MCP 协议提供给同事使用。\n\n## 固定端口配置\n\n> ⚠️ 以下端口已固定，请勿随意更改\n\n| 服务 | 端口 | 用途 |\n|------|------|------|\n| RAGFlow Web | **80** | Web UI |\n| RAGFlow API | **9380** | API 接口 |\n| RAGFlow Admin | **9381** | 管理服务 |\n| RAGFlow MCP | **9382** | 内置 MCP（未使用） |\n| **MCP Server** | **8000** | Claude Code 连接 |\n\n## 架构\n\n```\n┌─────────────────────────────────────────────────────────┐\n│  你的机器                                               │\n│                                                         │\n│   RAGFlow (Docker)  ←──→  MCP Server (:8000/sse)       │\n│   localhost:9380              ↑                         │\n│                               │ SSE                     │\n└───────────────────────────────│─────────────────────────┘\n                                │\n              ┌─────────────────┴─────────────────┐\n              │  同事机器                         │\n              │                                   │\n              │  Claude Code → MCP Client         │\n              │       ↓                           │\n              │  连接 http://你的IP:8000/sse      │\n              └───────────────────────────────────┘\n```\n\n## 文件说明\n\n| 文件 | 用途 | 使用者 |\n|-----|------|-------|\n| `start-all.sh` | 统一启动脚本（WSL） | 你 |\n| `start.bat` | 启动所有服务（Windows） | 你 |\n| `stop.bat` | 关闭所有服务 | 你 |\n| `restart.bat` | 重启所有服务 | 你 |\n| `setup-client.bat` | 一键配置 MCP | 同事 |\n| `setup-client.ps1` | 配置脚本 | 同事 |\n\n---\n\n## 你这边：启动服务\n\n### 方式一：WSL 环境（推荐）\n\n```bash\n# 使用统一启动脚本\nbash ~/ByoMCP/ragflow-mcp-server/start-all.sh\n```\n\n或手动启动：\n\n```bash\n# 1. 启动 RAGFlow（使用固定项目名保留数据）\ncd ~/ragflow_gitee/docker\ndocker compose -p ragflow up -d\n\n# 2. 等待 RAGFlow 就绪后启动 MCP Server\ncd ~/ByoMCP/ragflow-mcp-server\n~/.venvs/ragflow-mcp-wsl/bin/python mcp_server.py --sse --port 8000\n```\n\n### 方式二：Windows 环境\n\n双击 `start.bat`\n\n---\n\n## 同事这边：一键配置\n\n### 步骤 1：发送脚本给同事\n\n将 `setup-client.bat` 和 `setup-client.ps1` 发送给同事。\n\n### 步骤 2：同事运行脚本\n\n双击 `setup-client.bat`，输入你的 IP 地址。\n\n脚本会自动：\n1. 测试连接\n2. 创建配置文件\n3. 显示下一步操作\n\n### 步骤 3：重启 Claude Code\n\n```powershell\nclaude\n```\n\n---\n\n## 手动配置（备选）\n\n如果脚本无法运行，同事可以手动创建配置文件：\n\n**位置**：`%USERPROFILE%\\.claude\\.mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"enterprise-kb-qa\": {\n      \"type\": \"sse\",\n      \"url\": \"http://192.168.113.74:8000/sse\"\n    }\n  }\n}\n```\n\n> 将 `192.168.113.74` 替换为你的实际 IP。\n\n---\n\n## 使用方式\n\n配置完成后，直接向 Claude Code 提问：\n\n```\n用户: 从知识库查询 BDS 启动流程是什么？\n\nAI: [自动调用 enterprise-kb-qa 工具]\n    根据知识库内容回答...\n```\n\n---\n\n## 服务地址\n\n| 服务 | 地址 |\n|-----|------|\n| RAGFlow Web UI | http://localhost |\n| RAGFlow API | http://localhost:9380/api/v1 |\n| MCP Server | http://localhost:8000/sse |\n\n---\n\n## 数据持久化\n\nRAGFlow 数据存储在 Docker 卷中：\n\n```bash\n# 查看数据卷\ndocker volume ls | grep ragflow\n\n# 数据卷列表\n# - ragflow_esdata01    (Elasticsearch 索引)\n# - ragflow_mysql_data  (MySQL 数据库)\n# - ragflow_minio_data  (MinIO 对象存储)\n# - ragflow_redis_data  (Redis 缓存)\n```\n\n> ⚠️ 启动时必须使用 `-p ragflow` 项目名，否则会创建新卷导致数据丢失\n\n---\n\n## 故障排查\n\n### 同事无法连接\n\n1. 确认在同一局域网\n2. 确认 IP 地址正确\n3. 确认你这边已启动服务\n4. 检查防火墙是否放行 8000 端口\n\n### Claude Code 不显示 MCP 工具\n\n1. 检查配置文件 JSON 格式是否正确\n2. 确认 Claude Code 版本 ≥ 0.5.0\n3. 重启 Claude Code\n\n### RAGFlow 服务无法启动\n\n```bash\n# 查看日志\ndocker logs ragflow-ragflow-cpu-1 --tail 50\n\n# 重启服务\ncd ~/ragflow_gitee/docker\ndocker compose -p ragflow restart\n```","readmeFilename":"README.md"}