{"_id":"@byomcpserver/byo-mcp","_rev":"3-39ed423f5cda9248ea58c358d12d0a34","name":"@byomcpserver/byo-mcp","dist-tags":{"latest":"2.2.0"},"versions":{"2.0.0":{"name":"@byomcpserver/byo-mcp","version":"2.0.0","keywords":["mcp","ragflow","knowledge-base","byo","claude"],"author":{"name":"BYO"},"license":"MIT","_id":"@byomcpserver/byo-mcp@2.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":{"byo-mcp":"run.mjs"},"dist":{"shasum":"242837e6557f5e1f756e05971cf94d4146f72ec6","tarball":"https://registry.npmjs.org/@byomcpserver/byo-mcp/-/byo-mcp-2.0.0.tgz","fileCount":6,"integrity":"sha512-3hsjrGD+Q3GCJxqFHoMFQ10J+KtIwAxSVklWmldmqJxtvbORv5JpqWNL8VV2QfRPxBee4hhzgd5Go8yteA3MVg==","signatures":[{"sig":"MEUCICKOyTw80rZLUx3eqMMhUvwF4FDK9OfUkXcXjlfGlsiiAiEAm2RSp6NbzVOzHzcCto21lru1DgzFXBG9IHl4rQxdI2k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16264},"main":"mcp_server_cloud.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":"Byo MCP Server - Enterprise Knowledge Base MCP for RAGFlow (Cloud & Local)","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/byo-mcp_2.0.0_1784275736749_0.22342302777971979","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@byomcpserver/byo-mcp","version":"2.1.0","keywords":["mcp","ragflow","knowledge-base","byo","claude"],"author":{"name":"BYO"},"license":"MIT","_id":"@byomcpserver/byo-mcp@2.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":{"byo-mcp":"run.mjs"},"dist":{"shasum":"59845b6ef538b97826037c4b7b8658c00d88c41f","tarball":"https://registry.npmjs.org/@byomcpserver/byo-mcp/-/byo-mcp-2.1.0.tgz","fileCount":6,"integrity":"sha512-OW/r28yKwjPm6caLSFzcJxBJQ9Bq4WNnuHfykzo33+RDxC3Af6J8mm+SxXvT1752QQKujTg0vnay7ShTBIPPtQ==","signatures":[{"sig":"MEQCICmd3RkuuE/I1NN5jWZ6Wh9g6YcBc/lmgIv4aayASZUwAiBX8PwZP16bgPmUXwwaEGAwKdAC+vq9XiU/FuUq7T99Lg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19224},"main":"mcp_server_cloud.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":"Byo MCP Server - Enterprise Knowledge Base MCP for RAGFlow (Cloud & Local)","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/byo-mcp_2.1.0_1784276008421_0.18791149539014085","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@byomcpserver/byo-mcp","version":"2.2.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":"@byomcpserver/byo-mcp@2.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-hfDhJwPYpLylj5wzquttsNTeBbl1Jo0xwZZ2mSIVMhjUbho4b0H+h2vNtiaeNO3pPoiSBH57JTJ6LO9FEII7sQ==","shasum":"63d7668aea4984b295a0772d4d2f5a26d3f89411","tarball":"https://registry.npmjs.org/@byomcpserver/byo-mcp/-/byo-mcp-2.2.0.tgz","fileCount":6,"unpackedSize":17755,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCd0lgMrBB6TaXhKAYWCPNJFJd1YZqObfAyKniDDj0DFwIhAP5e0R0H8VVYAgjnhzaz2pzcsx/fXL9rvUxbvoTa4l3Q"}]},"_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.2.0_1784276276792_0.9285187882560373"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-17T08:08:56.590Z","modified":"2026-07-17T08:17:57.090Z","2.0.0":"2026-07-17T08:08:56.896Z","2.1.0":"2026-07-17T08:13:28.553Z","2.2.0":"2026-07-17T08:17:56.929Z"},"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","byo","claude"],"repository":{"type":"git","url":"git+https://github.com/ssssss1d/ragflow-mcp-marketplace.git"},"description":"Byo MCP Server - Enterprise Knowledge Base MCP for RAGFlow (Cloud & Local)","maintainers":[{"name":"cwc123456","email":"chenwenchao@byosoft.com.cn"}],"readme":"# Byo MCP Server\n\n企业知识库 MCP 服务，通过 npm 分发，支持云端和本地两种部署模式。\n\n## 架构\n\n```\n用户 Claude Code               云服务器                      内网 RAGFlow\n       │                          │                             │\n       │  MCP_USER_TOKEN           │                             │\n       ▼                          ▼                             ▼\n┌─────────────┐    HTTPS    ┌──────────────────────────┐    ┌──────────┐\n│ npx 包      │ ──────────→ │   Byo MCP Gateway        │ ──→│ RAGFlow  │\n│ (npm安装)   │             │   (FastAPI)              │    │ (知识库) │\n└─────────────┘             └──────────────────────────┘    └──────────┘\n```\n\n## 用户指南\n\n### 第一步：获取令牌\n\n联系管理员获取你的访问令牌（格式：`user_xxx`）。\n\n### 第二步：安装 MCP\n\n**方式 A：命令行安装（推荐）**\n\n```bash\nclaude mcp add byo-mcp \\\n  -e MCP_GATEWAY_URL=\"https://your-server.com\" \\\n  -e MCP_USER_TOKEN=\"user_xxx\" \\\n  -- npx -y @byomcpserver/byo-mcp\n```\n\n**方式 B：手动编辑配置文件**\n\n1. 打开配置文件：\n   - **Windows**: `%USERPROFILE%\\.claude\\claude_desktop_config.json`\n   - **Mac/Linux**: `~/.claude/claude_desktop_config.json`\n\n2. 添加配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"byo-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@byomcpserver/byo-mcp\"],\n      \"env\": {\n        \"MCP_GATEWAY_URL\": \"https://your-server.com\",\n        \"MCP_USER_TOKEN\": \"user_xxx\"\n      }\n    }\n  }\n}\n```\n\n**方式 C：已安装过，只添加 token**\n\n编辑配置文件，在 `byo-mcp` 的 `env` 中添加 `MCP_USER_TOKEN`。\n\n### 第三步：重启 Claude Code 使用\n\n```bash\nclaude\n```\n\n直接提问即可，Claude Code 会自动调用知识库：\n\n```\n帮我查一下知识库中关于 BIOS 启动流程的文档\n```\n\n---\n\n## 环境变量说明\n\n| 变量 | 必填 | 说明 |\n|-----|------|------|\n| `MCP_GATEWAY_URL` | ✅ | Gateway 服务器地址 |\n| `MCP_USER_TOKEN` | ✅ | 用户访问令牌 |\n\n---\n\n## 管理员指南\n\n### 快速部署 Gateway\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  # 修改密钥和密码\n\n# 3. 安装启动\npython3 -m venv venv && source venv/bin/activate\npip install -r requirements.txt\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# 创建用户（获取 user_xxx 令牌）\ncurl -X POST https://your-server/admin/users \\\n  -H \"Authorization: Bearer <admin-token>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"username\": \"zhangsan\", \"password\": \"pass123\", \"expires_days\": 30}'\n```\n\n将返回的 `access_token` 发给用户即可。\n\n详细部署文档：[gateway/DEPLOY.md](gateway/DEPLOY.md)\n\n---\n\n## 安全特性\n\n| 特性 | 说明 |\n|-----|------|\n| 用户令牌 | 每个用户独立令牌 |\n| 权限控制 | 可控制用户访问哪些知识库 |\n| 令牌过期 | 支持设置有效期 |\n| 访问日志 | 记录所有提问和回答 |\n| HTTPS | 传输加密 |\n\n---\n\n## 本地模式（测试用）\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 @byomcpserver/byo-mcp\n```\n\n---\n\n## 依赖\n\n- Python 3.10+\n- Node.js 18+\n- `pip install mcp httpx`\n\n---\n\n## 许可证\n\nMIT","readmeFilename":"README.md"}