{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_tfb7s84zgs22","handle":"cscec-login-mcp","url":"https://wellknown.network/agents/cscec-login-mcp","links":{"self":"https://wellknown.network/agents/cscec-login-mcp/record.json","html":"https://wellknown.network/agents/cscec-login-mcp","markdown":"https://wellknown.network/agents/cscec-login-mcp/record.md","api":"https://wellknown.network/api/v1/agents/cscec-login-mcp","status":"https://wellknown.network/api/v1/agents/cscec-login-mcp/status","claim":"https://wellknown.network/agents/cscec-login-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/cscec-login-mcp/claim.json","badge":"https://wellknown.network/agents/cscec-login-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:cscec-login-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"cscec-login-mcp","summary":"Stdio MCP server for CSCEC (中建三局) enterprise WeCom QR login","description":"# cscec-login-mcp\n\n一个**零依赖、可分发**的 MCP（Model Context Protocol）服务器，把\n**中建三局（CSCEC）门户的企业微信扫码登录**流程封装成标准化工具，供任意\nMCP 客户端（WorkBuddy、Claude Desktop 等）调用。\n\n> 适用场景：你要在自己的 AI 工作流 / 客户端里，让最终用户通过企业微信扫码登录\n> CSCEC 门户（及「应用商城」），并拿到门户 / 应用市场的令牌。\n\n---\n\n## 特性\n\n- **零第三方依赖**：只用 Python 标准库，`python3 mcp_server.py` 即可运行。\n- **9 个工具**：覆盖「生成二维码 → 等待扫码 → 兑换门户令牌 → 列出/搜索应用\n  → 选择应用 → 兑换应用市场令牌 → 查询令牌状态 → 清理会话」。\n- **内置登录页（产品级展示）**：`cscec_qr_create` 返回 `login_url` ——\n  一个本地 Web 登录页（`http://127.0.0.1:<port>/login?session=...`），页面\n  自动显示二维码、110 秒倒计时、**到期自动刷新二维码**（session_id 不变）、\n  实时扫码状态反馈、成功页。AI 客户端只需把这一个 URL 交给用户，用户在\n  浏览器里完成全部交互。SSO 长轮询由后台线程承担，页面状态查询即时返回。\n- **唯一展示通道**：浏览器登录页（`login_url`）。二维码在页面内渲染，\n  不依赖任何系统图片预览或桌面 PNG 副本。\n- **密钥不外露**：一次性 code、令牌只落在用户私有目录\n  `~/.cscec_qr_login/mcp/<session>/`，tool 结果一律脱敏。\n\n---\n\n## 前置条件\n\n- Python 3.10+\n\n## 安装 / 分发\n\n无需 `pip install`。把整个目录发给对方（或 `git clone`）即可：\n\n```bash\ngit clone <repo> cscec-login-mcp\n# 或直接拷贝目录\n```\n\n## 接入 MCP 客户端\n\n在客户端的 MCP 配置文件（如 `~/.workbuddy/mcp.json`、\n`claude_desktop_config.json`）里加：\n\n```json\n{\n  \"mcpServers\": {\n    \"cscec-wecom-qr-login\": {\n      \"command\": \"python3\",\n      \"args\": [\"/abs/path/to/cscec-login-mcp/mcp_server.py\"]\n    }\n  }\n}\n```\n\n> 若客户端无法解析 `python3`，把 `command` 换成绝对路径，例如\n> `/usr/bin/python3` 或 `~/.workbuddy/binaries/python/versions/3.13.12/bin/python3`。\n\n重启客户端后，9 个 `cscec_*` 工具即被加载。\n\n---\n\n## 工具一览\n\n| 工具 | 作用 |\n|---|---|\n| `cscec_qr_create` | 向 SSO 申请二维码，返回 `login_url`（登录页）等 |\n| `cscec_qr_wait` | 等待用户扫码（默认 100 秒；`session_id` 可传 `\"latest\"`） |\n| `cscec_portal_exchange` | 用一次性 code 兑换门户 `access_token` / `iam_token` |\n| `cscec_portal_list_apps` | 列出当前用户的门户应用（按「岗位场景」配置树） |\n| `cscec_portal_search_apps` | 按关键词搜索门户应用目录 |\n| `cscec_select_app` | 按序号选中某个应用 |\n| `cscec_exchange_market_code` | 用应用市场一次性 code 兑换 `xindun_token` |\n| `cscec_token_status` | 查询门户 / 应用市场令牌的非敏感状态 |\n| `cscec_session_cleanup` | 删除本次会话的私有文件 |\n\n## 典型流程\n\n```\n1. cscec_qr_create            → 拿到 login_url，立即 present 给用户（浏览器打开登录页）\n2. cscec_qr_wait              → 用户在登录页扫码（页面自动刷新码…","publisher":{"name":"CSCEC Login Team","url":null},"homepage":"https://internal/cscec-login-mcp","repository":null,"version":"1.0.1","license":"Proprietary — internal use only","protocols":["mcp"],"tags":["cscec","mcp","qr-login","wecom","portal"],"pricing":null,"endpoints":[{"url":"pypi:cscec-login-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":0.71,"provenance":"derived"}],"categories":["security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"cscec-login-mcp","registry":"pypi","observedAt":"2026-09-09T13:22:03.835Z","publishedAt":"2026-08-27T08:04:02.772657Z","latestVersion":"1.0.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"cscec-login-mcp","url":"https://pypi.org/project/cscec-login-mcp/","firstSeenAt":"2026-09-09T13:20:55.909Z","fetchedAt":"2026-09-09T13:20:55.909Z","normalizedAt":"2026-09-09T13:20:55.909Z"}]},"firstSeenAt":"2026-09-09T13:20:55.909Z","updatedAt":"2026-09-09T13:22:03.835Z"}