{"_id":"@byo-cwc/byo-mcp","name":"@byo-cwc/byo-mcp","dist-tags":{"latest":"2.0.0"},"versions":{"2.0.0":{"name":"@byo-cwc/byo-mcp","version":"2.0.0","description":"Byo MCP Server - Enterprise Knowledge Base MCP for RAGFlow (Cloud & Local)","main":"mcp_server_cloud.py","type":"module","bin":{"byo-mcp":"run.mjs"},"scripts":{"start":"node run.mjs"},"keywords":["mcp","ragflow","knowledge-base","byo","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/byo-mcp@2.0.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-7GMh9SBHbxvO0G0rHje5fQTPHV+ojjswfteLMUkmcL+6+8sOVdD1KoKu/D+F7n+lHMAd7lOBmQ/4ykwaP7MqUQ==","shasum":"a335c433e54c0ed6a77ee5dd609a375440846d20","tarball":"https://registry.npmjs.org/@byo-cwc/byo-mcp/-/byo-mcp-2.0.0.tgz","fileCount":6,"unpackedSize":16254,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDPdbQfsWQgukte/TrXOw11VB4YkLC4L8aXu7x3j1Fb+AIhAMbkTTGZYvXfKGS5SPwRA8+eWS00BFgLHaMhx2u/U8Gs"}]},"_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/byo-mcp_2.0.0_1784274941595_0.28791174305370637"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-17T07:55:41.397Z","2.0.0":"2026-07-17T07:55:41.729Z","modified":"2026-07-17T07:55:41.991Z"},"maintainers":[{"name":"cwc123456","email":"chenwenchao@byosoft.com.cn"}],"description":"Byo MCP Server - Enterprise Knowledge Base MCP for RAGFlow (Cloud & Local)","homepage":"https://github.com/ssssss1d/ragflow-mcp-marketplace#readme","keywords":["mcp","ragflow","knowledge-base","byo","claude"],"repository":{"type":"git","url":"git+https://github.com/ssssss1d/ragflow-mcp-marketplace.git"},"author":{"name":"BYO"},"bugs":{"url":"https://github.com/ssssss1d/ragflow-mcp-marketplace/issues"},"license":"MIT","readme":"# Byo MCP Server\n\n企业知识库 MCP 服务，通过 npm 分发，支持云端和本地两种部署模式。\n\n## 安装\n\n```bash\n# 短命令安装\nclaude mcp add byo-mcp -- npx -y @byo-cwc/byo-mcp\n```\n\n## 运行模式\n\n| 模式 | 说明 | 适用场景 |\n|-----|------|---------|\n| **云端模式** | 连接云服务器 Gateway | 推荐，安全可控 |\n| 本地模式 | 直接连接 RAGFlow | 仅限本地测试 |\n\n---\n\n## 云端模式（推荐）\n\n### 用户安装\n\n联系管理员获取访问令牌后：\n\n```bash\nclaude mcp add byo-mcp \\\n  -e MCP_GATEWAY_URL=\"https://your-gateway-server.com\" \\\n  -e MCP_USER_TOKEN=\"user_xxx\" \\\n  -- npx -y @byo-cwc/byo-mcp\n```\n\n### 使用\n\n配置完成后，直接向 Claude Code 提问：\n\n```\n用户: 从知识库查询 BDS 启动流程是什么？\n\nAI: [自动调用 byo-mcp 工具]\n    根据知识库内容回答...\n```\n\n---\n\n## 本地模式（测试用）\n\n需要本地运行 RAGFlow 服务：\n\n```bash\nclaude mcp add byo-mcp \\\n  -e RAGFLOW_API_URL=\"http://localhost:9380/api/v1\" \\\n  -e RAGFLOW_API_TOKEN=\"ragflow-xxx\" \\\n  -- npx -y @byo-cwc/byo-mcp\n```\n\n---\n\n## 管理员：部署 Gateway 服务\n\n详见 [gateway/DEPLOY.md](gateway/DEPLOY.md)\n\n### 快速部署\n\n```bash\n# 1. 上传代码到服务器\nscp -r gateway/ user@server:/opt/byo-mcp/\n\n# 2. 配置环境变量\ncd /opt/byo-mcp/gateway\ncp .env.example .env\nvim .env  # 修改 JWT_SECRET_KEY, ADMIN_PASSWORD, RAGFLOW_API_TOKEN\n\n# 3. 安装依赖\npython3 -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\n\n# 4. 启动服务\nuvicorn main:app --host 0.0.0.0 --port 8001\n```\n\n### 用户管理\n\n```bash\n# 管理员登录获取令牌\ncurl -X POST https://your-server/admin/login \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"username\": \"admin\", \"password\": \"your-password\"}'\n\n# 创建用户\ncurl -X POST https://your-server/admin/users \\\n  -H \"Authorization: Bearer <admin-token>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"username\": \"user1\", \"password\": \"pass123\", \"expires_days\": 30}'\n```\n\n---\n\n## 安全特性\n\n| 特性 | 说明 |\n|-----|------|\n| 用户令牌 | 每个用户独立令牌，不暴露 RAGFlow API Token |\n| 权限控制 | 可控制用户访问哪些知识库 |\n| 令牌过期 | 支持设置有效期，自动失效 |\n| 访问日志 | 记录所有提问和回答 |\n| 传输加密 | 使用 HTTPS |\n\n---\n\n## 依赖\n\n- Python 3.10+\n- Node.js 18+（npx 运行）\n- MCP 包：`pip install mcp httpx`\n\n---\n\n## 文件结构\n\n```\nragflow-mcp-server/\n├── run.mjs                  # npx 入口\n├── mcp_server_cloud.py      # 云端版 MCP\n├── mcp_server_npx.py        # 本地版 MCP\n├── package.json             # npm 配置\n├── requirements.txt         # Python 依赖\n├── gateway/                 # 云端 Gateway 服务\n│   ├── main.py              # FastAPI 主服务\n│   ├── config.py            # 配置\n│   ├── models.py            # 数据模型\n│   ├── database.py          # 数据库操作\n│   ├── mcp_proxy.py         # RAGFlow 代理\n│   ├── requirements.txt     # Gateway 依赖\n│   └── DEPLOY.md            # 部署文档\n└── README.md                # 本文件\n```\n\n---\n\n## 许可证\n\nMIT","readmeFilename":"README.md","_rev":"1-25adf11a59dee6147d33704b9aee1c64"}