{"_id":"qcc-dsh-mcp-legal-oauth","_rev":"6-7c043771e1983e68871f2667171c71db","name":"qcc-dsh-mcp-legal-oauth","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.0":{"name":"qcc-dsh-mcp-legal-oauth","version":"0.1.0","keywords":["deepseek-harness","dsh","cordis","mcp","qichacha","qcc","oauth","pkce","legal","regulation","case"],"license":"MIT","_id":"qcc-dsh-mcp-legal-oauth@0.1.0","maintainers":[{"name":"duhu2000","email":"dlaohu2008@gmail.com"}],"homepage":"https://github.com/duhu2000/qcc-mcp-legal-oauth#readme","bugs":{"url":"https://github.com/duhu2000/qcc-mcp-legal-oauth/issues"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"12aa0f8ef4886b95fa55859628927d9e5dee2c13","tarball":"https://registry.npmjs.org/qcc-dsh-mcp-legal-oauth/-/qcc-dsh-mcp-legal-oauth-0.1.0.tgz","fileCount":13,"integrity":"sha512-/BWXGQnAFyEpBdgWJxiuXwJ0q6oYtLKUr+H8r5MeIj1hvFUQLCkkcKI3OSKcL8NPLxH6u7YRPw82/3X+I1ugkA==","signatures":[{"sig":"MEUCIDV2FGg+2eF/j0Sc3yW/ZjhWrtjGSRPrLJJlrdwqafWvAiEAhtHu2uOEWYUBLvvIZRLI1M7zHP5eIgfau2CJqg6Xj9o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61775},"main":"lib/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./lib/index.js"},"gitHead":"a44d6830fca4779ed4066489842b42f2acc79970","scripts":{"lint":"node --check lib/index.js && node --check lib/oauth.js && node --check lib/callback-server.js && node --check lib/grant-store.js && node --check lib/mcp-provision.js && node --check lib/tools.js && node --check lib/util.js && node --check lib/constants.js","test":"node --test"},"_npmUser":{"name":"duhu2000","email":"dlaohu2008@gmail.com"},"repository":{"url":"git+https://github.com/duhu2000/qcc-mcp-legal-oauth.git","type":"git"},"_npmVersion":"11.12.1","description":"DeepSeek Harness 插件：一键 OAuth 授权连接企查查（Qichacha）法律数据 MCP（法规/reg 案例） / One-click OAuth connect to Qichacha Legal MCP (regulation & case)","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"peerDependencies":{"zod":"^4.4.0","cordis":"^4.0.1","@deepseek-ai/schemastery":"^3.18.1","@deepseek-ai/dsh-mcp-client":"^0.1.0-rc.6"},"_npmOperationalInternal":{"tmp":"tmp/qcc-dsh-mcp-legal-oauth_0.1.0_1787108681629_0.7086763864106906","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"qcc-dsh-mcp-legal-oauth","version":"0.1.1","keywords":["deepseek-harness","dsh","cordis","mcp","mcp-client","mcp-server","qichacha","qcc","oauth","oauth2","pkce","legal","law","legal-tech","legal-data","regulation","case","企查查","法律数据","法律产品"],"license":"MIT","_id":"qcc-dsh-mcp-legal-oauth@0.1.1","maintainers":[{"name":"duhu2000","email":"dlaohu2008@gmail.com"}],"homepage":"https://github.com/duhu2000/qcc-mcp-legal-oauth#readme","bugs":{"url":"https://github.com/duhu2000/qcc-mcp-legal-oauth/issues"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"542ef0829698588fe269000422406bf54de70c08","tarball":"https://registry.npmjs.org/qcc-dsh-mcp-legal-oauth/-/qcc-dsh-mcp-legal-oauth-0.1.1.tgz","fileCount":13,"integrity":"sha512-KeHWP8iI+AcgtgSm3ms5AK7lFKsIHysTjQyW6+g682eT58MNSXrgtzaspcwRnGDfdJHSNbMPzEb4q3IzCiYlfQ==","signatures":[{"sig":"MEUCIBVo9OBc7QPf2lqfVqoFExSn0lujomkRnsC8NlAyM9OmAiEAnxL2WlFONyKZ3b06pgyQ2LC9QtIXvzkQV/XoZfciQ2c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63174},"main":"lib/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./lib/index.js"},"gitHead":"b442365721d230d75b2617434555072006fdf7cb","scripts":{"lint":"node --check lib/index.js && node --check lib/oauth.js && node --check lib/callback-server.js && node --check lib/grant-store.js && node --check lib/mcp-provision.js && node --check lib/tools.js && node --check lib/util.js && node --check lib/constants.js","test":"node --test","verify-pack":"node scripts/verify-pack.mjs"},"_npmUser":{"name":"duhu2000","email":"dlaohu2008@gmail.com"},"repository":{"url":"git+https://github.com/duhu2000/qcc-mcp-legal-oauth.git","type":"git"},"_npmVersion":"11.12.1","description":"DeepSeek Harness 插件：一键 OAuth 授权连接企查查（Qichacha）法律数据 MCP（法律产品：法规/reg 案例） / One-click OAuth connect to Qichacha Legal MCP (regulation & case)","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"peerDependencies":{"zod":"^4.4.0","cordis":"^4.0.1","@deepseek-ai/schemastery":"^3.18.1","@deepseek-ai/dsh-mcp-client":"^0.1.0-rc.6"},"_npmOperationalInternal":{"tmp":"tmp/qcc-dsh-mcp-legal-oauth_0.1.1_1787112866481_0.3128085458286425","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"qcc-dsh-mcp-legal-oauth","version":"0.1.2","keywords":["deepseek-harness","dsh","cordis","mcp","mcp-client","mcp-server","qichacha","qcc","oauth","oauth2","pkce","legal","law","legal-tech","legal-data","regulation","case","企查查","法律数据","法律产品"],"license":"MIT","_id":"qcc-dsh-mcp-legal-oauth@0.1.2","maintainers":[{"name":"duhu2000","email":"dlaohu2008@gmail.com"}],"homepage":"https://github.com/duhu2000/qcc-mcp-legal-oauth#readme","bugs":{"url":"https://github.com/duhu2000/qcc-mcp-legal-oauth/issues"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"deeebf0f7aefaa7fd8c41ded7010c847a7875244","tarball":"https://registry.npmjs.org/qcc-dsh-mcp-legal-oauth/-/qcc-dsh-mcp-legal-oauth-0.1.2.tgz","fileCount":13,"integrity":"sha512-EkIU/JOCVql4hke7pmLa09lLmHWRzgRG669OUayw5Llf7bVIaBjN1ux7k75qQVtAURxuAlopl4yQ5FeKsX8MMQ==","signatures":[{"sig":"MEQCIBsU4NAMnNpaOPbr8U7jqKaiMKoIPnPcjLFI6MSZIb0mAiBDzHHnJJvh3Hler14PxoWMZ+1F4hymQ732J70YUxpsGQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63407},"main":"lib/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./lib/index.js"},"gitHead":"35b7740b8f242a4c91861b311d243aa7346cec72","scripts":{"lint":"node --check lib/index.js && node --check lib/oauth.js && node --check lib/callback-server.js && node --check lib/grant-store.js && node --check lib/mcp-provision.js && node --check lib/tools.js && node --check lib/util.js && node --check lib/constants.js","test":"node --test","verify-pack":"node scripts/verify-pack.mjs"},"_npmUser":{"name":"duhu2000","email":"dlaohu2008@gmail.com"},"repository":{"url":"git+https://github.com/duhu2000/qcc-mcp-legal-oauth.git","type":"git"},"_npmVersion":"11.12.1","description":"DeepSeek Harness 插件：一键 OAuth 授权连接企查查（Qichacha）法律数据 MCP（法律产品：法规/reg 案例） / One-click OAuth connect to Qichacha Legal MCP (regulation & case)","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"peerDependencies":{"zod":"^4.4.0","cordis":"^4.0.1","@deepseek-ai/schemastery":"^3.18.1","@deepseek-ai/dsh-mcp-client":"^0.1.0-rc.6"},"_npmOperationalInternal":{"tmp":"tmp/qcc-dsh-mcp-legal-oauth_0.1.2_1787115932968_0.8261571454992596","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"qcc-dsh-mcp-legal-oauth","version":"0.1.3","keywords":["deepseek-harness","dsh","cordis","mcp","mcp-client","mcp-server","qichacha","qcc","oauth","oauth2","pkce","legal","law","legal-tech","legal-data","regulation","case","企查查","法律数据","法律产品"],"license":"MIT","_id":"qcc-dsh-mcp-legal-oauth@0.1.3","maintainers":[{"name":"duhu2000","email":"dlaohu2008@gmail.com"}],"homepage":"https://github.com/duhu2000/qcc-mcp-legal-oauth#readme","bugs":{"url":"https://github.com/duhu2000/qcc-mcp-legal-oauth/issues"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"219761b152c929f80c6ba4334095a41c5fbb1b30","tarball":"https://registry.npmjs.org/qcc-dsh-mcp-legal-oauth/-/qcc-dsh-mcp-legal-oauth-0.1.3.tgz","fileCount":13,"integrity":"sha512-riSzPJ7irMlSPKgv2jRpgzDTo1L3IvIm3HyiFP2XRA30jS7+pZZh6qfA6UzG24XUO5V419pvWeh5VEpO/G65dg==","signatures":[{"sig":"MEYCIQDL+0Vc1FPXJCBki6lf3kTl2nUHw6hDgMO09eq0mSNY2AIhAMVGyLzvetvtjB0kgjZbTep0lQJHhfqDtK6jq7bMz7tQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63702},"main":"lib/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./lib/index.js"},"gitHead":"3cac4e6c424c2f8d35688d5c83cad8285a3a9bc4","scripts":{"lint":"node --check lib/index.js && node --check lib/oauth.js && node --check lib/callback-server.js && node --check lib/grant-store.js && node --check lib/mcp-provision.js && node --check lib/tools.js && node --check lib/util.js && node --check lib/constants.js","test":"node --test","verify-pack":"node scripts/verify-pack.mjs"},"_npmUser":{"name":"duhu2000","email":"dlaohu2008@gmail.com"},"repository":{"url":"git+https://github.com/duhu2000/qcc-mcp-legal-oauth.git","type":"git"},"_npmVersion":"11.12.1","description":"DeepSeek Harness 插件：一键 OAuth 授权连接企查查（Qichacha）法律数据 MCP（法律产品：法规/reg 案例） / One-click OAuth connect to Qichacha Legal MCP (regulation & case)","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"peerDependencies":{"zod":"^4.4.0","cordis":"^4.0.1","@deepseek-ai/schemastery":"^3.18.1","@deepseek-ai/dsh-mcp-client":"^0.1.0-rc.6"},"_npmOperationalInternal":{"tmp":"tmp/qcc-dsh-mcp-legal-oauth_0.1.3_1787124404287_0.6560296719683982","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"qcc-dsh-mcp-legal-oauth","version":"0.1.4","keywords":["deepseek-harness","dsh","cordis","mcp","mcp-client","mcp-server","qichacha","qcc","oauth","oauth2","pkce","legal","law","legal-tech","legal-data","regulation","case","企查查","法律数据","法律产品"],"license":"MIT","_id":"qcc-dsh-mcp-legal-oauth@0.1.4","maintainers":[{"name":"duhu2000","email":"dlaohu2008@gmail.com"}],"homepage":"https://github.com/duhu2000/qcc-mcp-legal-oauth#readme","bugs":{"url":"https://github.com/duhu2000/qcc-mcp-legal-oauth/issues"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"d31250d901203ca85a83711b1c85c23eded5574c","tarball":"https://registry.npmjs.org/qcc-dsh-mcp-legal-oauth/-/qcc-dsh-mcp-legal-oauth-0.1.4.tgz","fileCount":13,"integrity":"sha512-mJFO/cc+i4UgKkn7kwc5Yu8TE94CmVpxSnakZYDRpG1pIWvfYb6XTjscw73+/mkemybXi9mF9F+SKUiNz0OrWA==","signatures":[{"sig":"MEUCIBHiTcgQAjIkvIgOLEWXNY42j6QfxQclfzkaUni1QqZIAiEA4/HUfJA18oSp1JMouQoxvDp4bvDNWTFl82cQwGGV334=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63894},"main":"lib/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./lib/index.js"},"gitHead":"5b460ebcaf5179c21262ea3e28d66f2f7b7936ab","scripts":{"lint":"node --check lib/index.js && node --check lib/oauth.js && node --check lib/callback-server.js && node --check lib/grant-store.js && node --check lib/mcp-provision.js && node --check lib/tools.js && node --check lib/util.js && node --check lib/constants.js","test":"node --test","verify-pack":"node scripts/verify-pack.mjs"},"_npmUser":{"name":"duhu2000","email":"dlaohu2008@gmail.com"},"repository":{"url":"git+https://github.com/duhu2000/qcc-mcp-legal-oauth.git","type":"git"},"_npmVersion":"11.12.1","description":"DeepSeek Harness 插件：一键 OAuth 授权连接企查查（Qichacha）法律数据 MCP（法律产品：法规/reg 案例） / One-click OAuth connect to Qichacha Legal MCP (regulation & case)","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"peerDependencies":{"zod":"^4.4.0","cordis":"^4.0.1","@deepseek-ai/schemastery":"^3.18.1","@deepseek-ai/dsh-mcp-client":"^0.1.0-rc.6"},"_npmOperationalInternal":{"tmp":"tmp/qcc-dsh-mcp-legal-oauth_0.1.4_1787125901129_0.4946668526911999","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"_id":"qcc-dsh-mcp-legal-oauth@0.1.5","dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"bugs":{"url":"https://github.com/duhu2000/qcc-mcp-legal-oauth/issues"},"dist":{"shasum":"74db5dd9849f45d5ec38a7970dee0f061f3990e2","tarball":"https://registry.npmjs.org/qcc-dsh-mcp-legal-oauth/-/qcc-dsh-mcp-legal-oauth-0.1.5.tgz","fileCount":13,"integrity":"sha512-G0yxIvkE/HyT3vnZ/yXlSnPvU+K98RBalkor3xBFKClrjUrGkn0vTdtoXZnbzBpZSBvvEQkRuHeax0umenDR+Q==","signatures":[{"sig":"MEUCIDWvJycxIcHPTsYkHw7xE961rY/4IVRito5Og4fu2nzJAiEAzMlupiTN5FCy3jDV6EvgJ1TwvpM/8yc/XoVVIUawP28=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGTJd4VAZnc2BK8c+RGstoB4JWxY5GhbvOlt5XVEjzFCAiBoX1dSS25Wh43bfNDQ34Bv+vF91LO63ZCIMxq5iMZSSg=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/qcc-dsh-mcp-legal-oauth@0.1.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":65038},"main":"lib/index.js","name":"qcc-dsh-mcp-legal-oauth","type":"module","engines":{"node":">=20"},"exports":{".":"./lib/index.js"},"gitHead":"01865bb7f6194057ed133ebe24a22f41951a8ef1","license":"MIT","scripts":{"lint":"node --check lib/index.js && node --check lib/oauth.js && node --check lib/callback-server.js && node --check lib/grant-store.js && node --check lib/mcp-provision.js && node --check lib/tools.js && node --check lib/util.js && node --check lib/constants.js","test":"node --test","verify-pack":"node scripts/verify-pack.mjs"},"version":"0.1.5","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"16e393a1-95d6-4e0a-8e90-f2ad6efa3d0e"}},"homepage":"https://github.com/duhu2000/qcc-mcp-legal-oauth#readme","keywords":["deepseek-harness","dsh","cordis","mcp","mcp-client","mcp-server","qichacha","qcc","oauth","oauth2","pkce","legal","law","legal-tech","legal-data","regulation","case","企查查","法律数据","法律产品"],"repository":{"url":"git+https://github.com/duhu2000/qcc-mcp-legal-oauth.git","type":"git"},"_npmVersion":"11.19.0","description":"DeepSeek Harness 插件：一键 OAuth 授权连接企查查（Qichacha）法律数据 MCP（法律产品：法规/reg 案例） / One-click OAuth connect to Qichacha Legal MCP (regulation & case)","directories":{},"maintainers":[{"name":"duhu2000","email":"dlaohu2008@gmail.com"}],"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"devDependencies":{"zod":"4.4.3","semver":"^7.7.2","@deepseek-ai/cordis":"4.0.4","@deepseek-ai/dsh-storage":"0.2.0-rc.2","@deepseek-ai/schemastery":"3.18.4","@deepseek-ai/dsh-storage-domain":"0.2.0-rc.2"},"peerDependencies":{"zod":"^4.4.3","@deepseek-ai/cordis":"~4.0.4","@deepseek-ai/dsh-tools":"^0.2.0-rc.2","@deepseek-ai/schemastery":"~3.18.4","@deepseek-ai/dsh-mcp-client":"^0.2.0-rc.2","@deepseek-ai/dsh-storage-domain":"^0.2.0-rc.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/qcc-dsh-mcp-legal-oauth_0.1.5_1792143975419_0.20928752695504493"}}},"time":{"created":"2026-08-19T03:04:41.484Z","modified":"2026-10-16T09:46:15.892Z","0.1.0":"2026-08-19T03:04:41.762Z","0.1.1":"2026-08-19T04:14:26.647Z","0.1.2":"2026-08-19T05:05:33.115Z","0.1.3":"2026-08-19T07:26:44.431Z","0.1.4":"2026-08-19T07:51:41.271Z","0.1.5":"2026-10-16T09:46:15.533Z"},"bugs":{"url":"https://github.com/duhu2000/qcc-mcp-legal-oauth/issues"},"license":"MIT","homepage":"https://github.com/duhu2000/qcc-mcp-legal-oauth#readme","keywords":["deepseek-harness","dsh","cordis","mcp","mcp-client","mcp-server","qichacha","qcc","oauth","oauth2","pkce","legal","law","legal-tech","legal-data","regulation","case","企查查","法律数据","法律产品"],"repository":{"url":"git+https://github.com/duhu2000/qcc-mcp-legal-oauth.git","type":"git"},"description":"DeepSeek Harness 插件：一键 OAuth 授权连接企查查（Qichacha）法律数据 MCP（法律产品：法规/reg 案例） / One-click OAuth connect to Qichacha Legal MCP (regulation & case)","maintainers":[{"name":"duhu2000","email":"dlaohu2008@gmail.com"}],"readme":"# 企查查法律数据 MCP OAuth 插件（DeepSeek Harness）\n\n> One-click OAuth connect to [企查查 (Qichacha) 法律数据 MCP](https://agent.qcc.com/legal) inside DeepSeek Harness.\n> 在 DeepSeek Harness 中一键 OAuth 授权接入企查查法律数据 MCP（**法规法条 / 司法案例**）。\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n## 功能 / Features\n\n- 🔑 **一键 OAuth 连接**：`Authorization Code + PKCE(S256)`，动态注册客户端（无 client_secret），自动打开浏览器跳转企查查授权页，loopback 回调自动完成\n- 🌐 **一次授权、全 Server 可用**：一份 `access_token` / `refresh_token` 覆盖企查查法律数据 MCP SERVER（`legal-regulation` 法规 / `legal-case` 案例，共 2 个）；插件按 token 实际授权范围动态挂载——同时开通法规+案例的账号 2 个、仅开通法规的账号 1 个\n- 🔄 **自动刷新**：access_token 过期前自动 refresh（token 轮换），失败才需要重新授权\n- 💾 **安全持久化**：token 存储于 DSH 存储域（`~/.dsh/storages`，目录 0700），重启 Host 自动恢复连接\n- 🛠 **对话即管理**：内置 `qcc_legal_oauth_connect` / `qcc_legal_oauth_status` / `qcc_legal_oauth_disconnect` 三个工具\n- 🚪 **一键断开**：调用 OAuth revoke 撤销 refresh_token 并停用 MCP 工具\n- 🧩 **与企业数据插件可共存**：工具名、存储域、条目 id 与「企查查 MCP OAuth 插件」（company/risk/...）完全独立，可同时安装\n\n## 安装 / Install\n\n前置：DeepSeek Harness **0.2.0-rc.2**（`dsh` CLI，web profile），Node ≥ 20。插件 **0.1.5** 起适配 DSH 0.2 系列，已验证目标版本为 0.2.0-rc.2。\n\n### 从 0.1.4 升级（DSH 0.2.0-rc.2 不兼容提示）\n\n0.1.4 的 `@deepseek-ai/dsh-mcp-client` 对等依赖仅接受 `^0.1.0-rc.6`，DSH 0.2.0-rc.2 会因此拒绝加载。0.1.5 已更新兼容声明，并对齐新版 `@deepseek-ai/cordis`、存储域与工具服务依赖。\n\n如果 npm 尚未发布 0.1.5，可在本仓库目录打包并安装本地修复版（先停止正在运行的 DSH）：\n\n```bash\nnpm pack\ndsh plugin --profile web add ./qcc-dsh-mcp-legal-oauth-0.1.5.tgz\n# 重启 dsh web\n```\n\n0.1.5 发布到 npm 后，可执行 `dsh plugin --profile web add qcc-dsh-mcp-legal-oauth@0.1.5`，再重启。\n\n### 🤖 让 Agent 安装（最省事，推荐给不熟悉命令行的用户）\n\n把下面的链接直接发给你的 DeepSeek Harness 对话（推荐先在 [dshmarket](https://www.npmjs.com/package/dshmarket) 插件市场搜索「企查查法律数据」一键安装；市场直装失败时，同样把链接发给 Agent 即可代为安装）：\n\n```\n帮我安装这个插件 https://github.com/duhu2000/qcc-mcp-legal-oauth\n```\n\nAgent 会按本 README 执行以下命令（你也可以自己跑）：\n\n```bash\n# 方式一：一键脚本（自动安装 + 注册 bundle + 提示重启）\nbash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/qcc-mcp-legal-oauth/main/install.sh)\n\n# 方式二：手动两步\ndsh plugin --profile web add qcc-dsh-mcp-legal-oauth   # 安装依赖并自动注册 bundle\n# 重启 dsh web\n```\n\n> 说明：`@deepseek-ai/*` 等对等依赖由 DSH web profile 提供，无需另行安装。如提示版本不兼容，应安装适配版本；安装完成后**必须重启** dsh web 才能生效。\n\n### 方式 A：npm 安装\n\n```bash\n# 1. 安装插件到 profile（声明了 dsh.bundle 的包会被 dsh plugin add 自动注册到 bundles）\ndsh plugin --profile web add qcc-dsh-mcp-legal-oauth\n\n# 2. 重启 dsh web\n```\n> 若未自动注册：手动在 ~/.dsh/profiles/web/package.json 的 `dsh.profile.bundles` 追加\n> `\"qcc-dsh-mcp-legal-oauth\"`（与 `@deepseek-ai/dsh-base`、`@deepseek-ai/dsh-web-app` 并列），再重启。\n\n### 方式 B：GitHub 直装\n\n```bash\ndsh plugin --profile web add github:duhu2000/qcc-mcp-legal-oauth\n# 再重启 dsh web\n```\n\n### 方式 C：源码 / 本地调试\n\n```bash\ngit clone https://github.com/duhu2000/qcc-mcp-legal-oauth.git\ncd qcc-mcp-legal-oauth\ndsh plugin --profile web add \"link:$(pwd)\"      # 或 pnpm add \"file:$(pwd)\"\n# 再重启 dsh web\n```\n\n> 插件包内自带 `cordis.patch.yml`（bundle patch）；`dsh plugin add` 自动完成依赖安装与 bundles 注册，插件行自动合入，无需手改任何文件。\n\n## 使用 / Usage\n\n重启后，插件会**自动发起 OAuth 授权**（默认开启，激活且无有效授权时自动打开企查查授权页）；如未自动触发，在对话中输入：\n\n| 你说 | 效果 |\n|---|---|\n| \"连接企查查法律数据\" | 触发 `qcc_legal_oauth_connect`：自动打开浏览器跳转企查查授权页，登录授权后自动完成连接 |\n| \"查一下企查查法律数据连接状态\" | 触发 `qcc_legal_oauth_status`：显示授权状态、token 过期时间、覆盖的 MCP Server |\n| \"断开企查查法律数据\" | 触发 `qcc_legal_oauth_disconnect`：撤销 refresh_token、清除本地授权、停用工具 |\n\n连接成功后，以下工具直接可用（示例）：\n\n- `mcp__legal-regulation__*`：`regulation_search`（法规关键词检索）、`regulation_detail`（法规全文）、`regulation_detail_article`（法条原文）等\n- `mcp__legal-case__*`：`case_search`（案例关键词检索）、`case_detail`（案例完整文书）等\n- 溯源工具：法规溯源 / 案例溯源（引用核验 + 可点击超链）\n\n## 原理 / How it works\n\n严格遵循《企查查MCP OAuth 接入文档》（Authorization Code + PKCE，公开接口版），与企业数据 MCP 插件共用同一套授权服务器：\n\n1. 发现 MCP Protected Resource Metadata → 2. 发现 OAuth Server Metadata（endpoint 全部动态读取，不硬编码）\n3. 动态注册客户端（`client_id`，90 天自动续期）→ 4. 打开授权页（`scope=mcp:tools`）\n5. loopback 回调校验 `state` → 6. 授权码 + `code_verifier` 换 token\n7. 解析 token 实际授权的 resource（JWT claim），通过 `ctx.loader` 为授权的 `@deepseek-ai/dsh-mcp-client` 条目注入 Bearer header（法规+案例 2 个 / 仅法规 1 个）→ 8. 过期前自动刷新（轮换）\n\n![架构与授权流程](docs/architecture.svg)\n\n详见 [`docs/OAUTH-IMPLEMENTATION.md`](docs/OAUTH-IMPLEMENTATION.md)。\n\n工具清单与调用示例详见 [`docs/TOOLS.md`](docs/TOOLS.md)。\n\n## 配置 / Configuration\n\n插件行位于 `~/.dsh/profiles/web/cordis.patch.yml`（bundle 合入后可见）：\n\n```yaml\n- id: qcc-legal-mcp-oauth\n  name: 'qcc-dsh-mcp-legal-oauth'\n  config:\n    issuer: 'https://agent.qcc.com'                 # OAuth 授权服务器\n    clientName: 'DeepSeek Harness - QCC Legal MCP'  # OAuth 客户端名（授权页展示 + 后台品牌识别依据）\n    refreshSkewMs: 300000                            # 过期前提前刷新（ms）\n    openBrowser: true                                # 自动打开浏览器（false = 仅打印授权 URL）\n    autoConnectOnActivate: true                      # 激活且无授权时自动打开授权页（false = 手动触发）\n    persistTokens: true                              # 持久化 token（false = 仅内存）\n    mcpEntryPrefix: 'mcp-qcc'                        # 受管 mcp-client 条目 id 前缀（条目：mcp-qcc-legal-regulation / mcp-qcc-legal-case）\n```\n\n> **关于 `clientName`**：它是 OAuth 协议的 `client_name`，会被企查查写入 access_token 的 `client_name` claim，用于**后台看板品牌识别**（企查查侧将名称去除空格/连字符/下划线并转小写后，按 `deepseekharness*` 前缀归一为激活来源 `deepseekharness`）。默认值 `DeepSeek Harness - QCC Legal MCP` 已命中该前缀。如需自定义，请**保持 `DeepSeek Harness` 前缀**，否则后台会归入「其他（未注册）」、无法正确统计品牌激活。\n\n## 安全说明 / Security\n\n- token 只写入 `~/.dsh/storages`（0700），**不进入 git、不进入对话历史**\n- 连接期间 `loader` 会把条目配置写回 profile 配置文件（含 token），建议：`chmod 600 ~/.dsh/profiles/web/cordis.yml`；不要把 `~/.dsh` 加入任何仓库\n- Bearer token 仅发送给授权集合内的精确 resource URL\n- 断开时调用 revoke 撤销 refresh_token\n- 如需彻底移除：`qcc_legal_oauth_disconnect` 后从 bundles 移除包名并 `dsh plugin --profile web remove qcc-dsh-mcp-legal-oauth`\n\n## 已知限制 / Limitations\n\n- 插件默认管理 2 个法律数据 SERVER（`legal-regulation` 法规 / `legal-case` 案例）；账号 token 可能只授权其一，插件按 token 实际授权范围动态挂载（2 个 / 1 个）\n- 企业数据 SERVER（company/risk/ipr/operation/history/executive）由独立的「企查查 MCP OAuth 插件」（`qcc-dsh-mcp-oauth`）管理，本插件不重复管理；两插件可同时安装\n- 第三方插件无法注册 DSH 设置页卡片（apiproxy allowlist 限制），管理入口为对话工具\n- 回调使用本地 loopback 地址，适用于桌面端；SaaS/Web 回调地址需提前与企查查确认白名单\n- 静态 API Key（Bearer YOUR_API_KEY）直连属企查查另一直连通道，不属本插件职责；如需静态 Key，直接用普通 mcp-client 配置即可\n\n## 开发 / Development\n\n```bash\nnpm install --ignore-scripts --legacy-peer-deps --no-package-lock  # 安装固定的开发测试依赖，不拉入完整 DSH 宿主\nnpm run lint         # 语法检查\nnpm test             # 单元 + 集成测试（含 mock OAuth 服务器全流程）\n```\n\n测试覆盖：PKCE、元数据发现、动态注册、完整授权码流程（loopback）、refresh 轮换、revoke、\n插件级集成（连接/幂等/自动刷新/断开/重启恢复/按 token 授权动态挂载）。\n\n## 插件市场收录与搜索关键词 / Marketplace\n\n本插件可通过以下渠道被发现与安装：\n\n1. **`dsh-plugin` topic（官方推荐发现渠道）**：DeepSeek Harness 官方推荐通过 GitHub `dsh-plugin` topic 发现插件，本仓库已打该 topic；[dsh-plugin-marketplace](https://github.com/AwesomeHou/dsh-plugin-marketplace) 等社区市场据此自动收录，搜索走 GitHub 仓库搜索（仓库名 / 描述 / topic），收录即时但无人工审核。\n2. **dshmarket（社区插件市场，人工精选 + PR 守门审核）**：数据源为 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 精选列表，仅安装列表内来源。本插件已提交收录 PR（`data/plugins/duhu2000__qcc-mcp-legal-oauth.yml`），合并后即可在「设置 → 插件市场」浏览、搜索「企查查法律数据」并一键安装。安装方式：官方 CLI 支持 `dsh plugin add <package>` 通用安装，dshmarket 依此提供 `dsh plugin --profile web add dshmarket`。\n\n为便于中文 / 英文检索，已覆盖以下关键词：\n\n- 中文：**企查查**、**法律产品**、**法律数据**、**法规**、**案例**（写入仓库描述与精选列表 zh 描述）\n- 英文：**qcc**、**qichacha**、**legal**、**law**、**legal-tech**、**legal-data**、**regulation**、**case**（写入仓库名 / 描述 / topic / npm keywords）\n\n## License\n\nMIT\n","readmeFilename":"README.md"}