{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6pwykcfgsr2b","handle":"zh-file-mcp","url":"https://wellknown.network/agents/zh-file-mcp","links":{"self":"https://wellknown.network/agents/zh-file-mcp/record.json","html":"https://wellknown.network/agents/zh-file-mcp","markdown":"https://wellknown.network/agents/zh-file-mcp/record.md","api":"https://wellknown.network/api/v1/agents/zh-file-mcp","status":"https://wellknown.network/api/v1/agents/zh-file-mcp/status","claim":"https://wellknown.network/agents/zh-file-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/zh-file-mcp/claim.json","badge":"https://wellknown.network/agents/zh-file-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:zh-file-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"zh-file-mcp","summary":"MCP file gateway for downloading and uploading business-system files into the agent workspace","description":"# zh-file-mcp\n\n`zh-file-mcp` is a stdio-first MCP file gateway. It downloads files from configured business systems into the agent workspace and uploads local workspace files back to those systems.\n\nIt is intentionally generic: systems such as `wpos` are configured with JSON instead of hard-coded MCP tools.\n\n## Features\n\n- Stdio MCP server for Cherry Studio, web-agent, and other MCP clients.\n- Config-driven HTTP download, upload, list, and metadata requests.\n- Cookie, bearer, custom header, static headers, and no-auth modes.\n- Files are written under the MCP process working directory.\n- Tool results return `relative_path` so agents can continue reading files.\n- Paths are constrained to the workspace.\n- Large business IDs can be passed as strings to avoid JavaScript precision loss.\n\n## Tools\n\n| Tool | Description |\n| --- | --- |\n| `get_workspace_info` | Show current working directory, download root, and configured systems. |\n| `download_file` | Download a configured system file into the workspace. |\n| `upload_file` | Upload a workspace file to a configured system. |\n| `list_files` | List files from a configured system, if the system defines `list`. |\n| `get_file_info` | Get file metadata, if the system defines `file_info`. |\n\n## Install\n\n```bash\ncd /Users/linchuanke/lck/zhonghui/zh-file-mcp\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -e .\n```\n\nVerify:\n\n```bash\n/Users/linchuanke/lck/zhonghui/zh-file-mcp/.venv/bin/zh-file-mcp --help\n```\n\nAfter code changes, reinstall:\n\n```bash\nsource .venv/bin/activate\npip install -e .\n```\n\nVersion `0.1.3` and later allow `extra` to be passed either as an object or as a JSON object string. If MCP still reports `extra Input should be a valid dictionary`, the running MCP process is still using an older install; restart the MCP client and make sure its command points to this updated environment.\n\n## Environment\n\n| Variable | Default | Description |\n| --- | --- | --- |\n| `FILE_MCP_SYSTEMS_JSON` | - | Inline JSON systems co…","publisher":null,"homepage":null,"repository":null,"version":"0.1.3","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:zh-file-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["dev"],"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":"zh-file-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:36.056Z","publishedAt":"2026-07-14T01:20:39.680307Z","latestVersion":"0.1.3"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"zh-file-mcp","url":"https://pypi.org/project/zh-file-mcp/","firstSeenAt":"2026-09-10T16:23:54.710Z","fetchedAt":"2026-09-10T16:23:54.710Z","normalizedAt":"2026-09-10T16:23:54.710Z"}]},"firstSeenAt":"2026-09-10T16:23:54.710Z","updatedAt":"2026-09-10T16:24:36.056Z"}