{"_id":"@bangdao-ai/ai-manage-tools","_rev":"8-ccd7ba8dbe1d7bbcc05e49bfb5f881c4","name":"@bangdao-ai/ai-manage-tools","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"@bangdao-ai/ai-manage-tools","version":"0.1.0","keywords":["ai-manager","usage-reporting","mcp"],"license":"UNLICENSED","_id":"@bangdao-ai/ai-manage-tools@0.1.0","maintainers":[{"name":"baigod","email":"387677341@qq.com"},{"name":"jingli.chang","email":"jingli.chang01@gmail.com"},{"name":"shaoshuai.liu","email":"shaoshuai.liu@bangdao-tech.com"},{"name":"ypsoul","email":"ypsoul94@163.com"},{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}],"bin":{"ai-manage-tools":"bin/ai-manage-tools.mjs"},"dist":{"shasum":"53e001d4faaf53323e9a9d17a38d811ef392f935","tarball":"https://registry.npmjs.org/@bangdao-ai/ai-manage-tools/-/ai-manage-tools-0.1.0.tgz","fileCount":9,"integrity":"sha512-Yd2D6FFjdytSgfUg3oY7NQkHEe7xlOJVqx2M23ckfpP6lbNb0nOwsfsL/cozLKQFVZFKvrwdoIqjG+pb8LzGtg==","signatures":[{"sig":"MEQCIBk7ekg4KGqndvdIdf1tNzjv19xjSC95DIj0KDimQ+ntAiBpMyYVBDISA4K8ySWBGtC5hof+xUmtQWF4mDSlCmk8SQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11047},"type":"module","engines":{"node":">=18"},"gitHead":"f37f57513eda761fc93eac029740ad0bee85357f","scripts":{"test":"uv run pytest -q && node --test tests/npm-wrapper.test.mjs","publish:npm":"../../script/publish-ai-manage-mcp-npm.sh","pack:dry-run":"npm pack --dry-run","publish:dry-run":"../../script/publish-ai-manage-mcp-npm.sh --dry-run"},"_npmUser":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"},"_npmVersion":"11.6.2","description":"NPM distribution wrapper for the AI Manager local usage collector and MCP package shell.","directories":{},"_nodeVersion":"24.11.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ai-manage-tools_0.1.0_1782143456660_0.009328448888834107","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bangdao-ai/ai-manage-tools","version":"0.1.1","keywords":["ai-manager","usage-reporting","mcp"],"license":"UNLICENSED","_id":"@bangdao-ai/ai-manage-tools@0.1.1","maintainers":[{"name":"baigod","email":"387677341@qq.com"},{"name":"jingli.chang","email":"jingli.chang01@gmail.com"},{"name":"shaoshuai.liu","email":"shaoshuai.liu@bangdao-tech.com"},{"name":"ypsoul","email":"ypsoul94@163.com"},{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}],"bin":{"ai-manage-tools":"bin/ai-manage-tools.mjs"},"dist":{"shasum":"2ceb62f5a7dfc6525716c85ea294df7556a2f713","tarball":"https://registry.npmjs.org/@bangdao-ai/ai-manage-tools/-/ai-manage-tools-0.1.1.tgz","fileCount":9,"integrity":"sha512-5LxULMwkczgnzH7n+YK22orpyeYDTEX+K3UZPWY970FUfytSK/Jfvd4j3fHuJIjowugZB979A0jitji1l1RKEQ==","signatures":[{"sig":"MEQCIA3mP8fPJT86PYuw+trETKxXCsXpw96NQKhnlWwVsdW2AiBwDw7hRR4Dyw324tAPqucCvyqNCpzaqqxq06EbjLBbxw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17279},"type":"module","engines":{"node":">=18"},"gitHead":"8028166088145a60eecbc7594bb27c1a69a50dcb","scripts":{"test":"uv run pytest -q && node --test tests/npm-wrapper.test.mjs","publish:npm":"../../script/publish-ai-manage-mcp-npm.sh","pack:dry-run":"npm pack --dry-run","publish:dry-run":"../../script/publish-ai-manage-mcp-npm.sh --dry-run"},"_npmUser":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"},"_npmVersion":"10.9.8","description":"AI Manager MCP server for AI usage reporting and local diagnostics.","directories":{},"_nodeVersion":"22.22.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ai-manage-tools_0.1.1_1782144211649_0.5242120301767768","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@bangdao-ai/ai-manage-tools","version":"0.2.0","keywords":["ai-manager","usage-reporting","mcp"],"license":"UNLICENSED","_id":"@bangdao-ai/ai-manage-tools@0.2.0","maintainers":[{"name":"baigod","email":"387677341@qq.com"},{"name":"jingli.chang","email":"jingli.chang01@gmail.com"},{"name":"shaoshuai.liu","email":"shaoshuai.liu@bangdao-tech.com"},{"name":"ypsoul","email":"ypsoul94@163.com"},{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}],"bin":{"ai-manage-tools":"bin/ai-manage-tools.mjs"},"dist":{"shasum":"3c9922b5dcf6ec0a37d80dc3a99bb195a50ce411","tarball":"https://registry.npmjs.org/@bangdao-ai/ai-manage-tools/-/ai-manage-tools-0.2.0.tgz","fileCount":19,"integrity":"sha512-0bXtfiB5aitsVaDYNdcasDxbh9gIgxYJDSq6cEaYSkG0toe0hIZC1flGo8/zffZB3j9a0s7WRi+4A9fPBvQOEA==","signatures":[{"sig":"MEQCIC54sbqcyDPpoVkW17+uHCdch15vrJL4q/FbN8UBv2mOAiBTyBsDyBcGPHKQuE9sTpmfGNIow1eWy/oh3MDoNxdb3A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57429},"type":"module","engines":{"node":">=18"},"gitHead":"8028166088145a60eecbc7594bb27c1a69a50dcb","scripts":{"test":"uv run pytest -q && node --test tests/npm-wrapper.test.mjs","publish:npm":"../../script/publish-ai-manage-mcp-npm.sh","pack:dry-run":"npm pack --dry-run","publish:dry-run":"../../script/publish-ai-manage-mcp-npm.sh --dry-run"},"_npmUser":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com","approver":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}},"_npmVersion":"11.17.0","description":"AI Manager MCP server for AI usage reporting and local diagnostics.","directories":{},"_nodeVersion":"22.22.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ai-manage-tools_0.2.0_1782189474333_0.3677158845171249","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@bangdao-ai/ai-manage-tools","version":"0.2.1","keywords":["ai-manager","usage-reporting","mcp"],"license":"UNLICENSED","_id":"@bangdao-ai/ai-manage-tools@0.2.1","maintainers":[{"name":"baigod","email":"387677341@qq.com"},{"name":"jingli.chang","email":"jingli.chang01@gmail.com"},{"name":"shaoshuai.liu","email":"shaoshuai.liu@bangdao-tech.com"},{"name":"ypsoul","email":"ypsoul94@163.com"},{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}],"bin":{"ai-manage-tools":"bin/ai-manage-tools.mjs"},"dist":{"shasum":"4294b3b96314b74a1333bc82cc0b0c4d724c656d","tarball":"https://registry.npmjs.org/@bangdao-ai/ai-manage-tools/-/ai-manage-tools-0.2.1.tgz","fileCount":19,"integrity":"sha512-7d99nr2IQbDQQ3FAXpZYt7DdX0BBaD8tPuJiNmkCQFkK63qz05JsPD1rmEZhPXK97JaFLBrngCN3isfiCEarDA==","signatures":[{"sig":"MEQCICQuNqFTgTmZTWJ5QavoxXk6EmiuBDJGMnZR2jR/cM4eAiBoaINL/x4Rb+USXkaGWcL2jGXQ1zv6+b7eehg3K9fSQA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61461},"type":"module","engines":{"node":">=18"},"gitHead":"11659d97520d6ed8baf5208ed549d74a8087f951","scripts":{"test":"uv run pytest -q && node --test tests/npm-wrapper.test.mjs","publish:npm":"../../script/publish-ai-manage-mcp-npm.sh","pack:dry-run":"npm pack --dry-run","publish:dry-run":"../../script/publish-ai-manage-mcp-npm.sh --dry-run"},"_npmUser":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com","approver":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}},"_npmVersion":"11.17.0","description":"AI Manager MCP server for AI usage reporting and local diagnostics.","directories":{},"_nodeVersion":"22.22.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ai-manage-tools_0.2.1_1782228629325_0.3920661329351418","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@bangdao-ai/ai-manage-tools","version":"0.2.2","keywords":["ai-manager","usage-reporting","mcp"],"license":"UNLICENSED","_id":"@bangdao-ai/ai-manage-tools@0.2.2","maintainers":[{"name":"baigod","email":"387677341@qq.com"},{"name":"jingli.chang","email":"jingli.chang01@gmail.com"},{"name":"shaoshuai.liu","email":"shaoshuai.liu@bangdao-tech.com"},{"name":"ypsoul","email":"ypsoul94@163.com"},{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}],"bin":{"ai-manage-tools":"bin/ai-manage-tools.mjs"},"dist":{"shasum":"827fa8ea2296fbf68f17a42da17ed6cd83a45de6","tarball":"https://registry.npmjs.org/@bangdao-ai/ai-manage-tools/-/ai-manage-tools-0.2.2.tgz","fileCount":19,"integrity":"sha512-/Tan09kujnJ+b3lPcmBn3CNOvbXpbmuAOuPxNk7PSbYRhtio4SMrhv2xSQSUqE1LQW2QXYXy/fFfoS3r4X3msw==","signatures":[{"sig":"MEQCIGLODWAR4B5KDFte5LNBJAi1vpIvYkz6H9saYz+ZwWtbAiBi6yJsMmjOfNyn+yLptPlX0KwbA+qCisENqo/+JNrd4A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94746},"type":"module","engines":{"node":">=18"},"gitHead":"244e5a6fe640dd37d0bf5f46ebb2f1efeb4b775a","scripts":{"test":"uv run pytest -q && node --test tests/npm-wrapper.test.mjs","publish:npm":"../../script/publish-ai-manage-mcp-npm.sh","pack:dry-run":"npm pack --dry-run","publish:dry-run":"../../script/publish-ai-manage-mcp-npm.sh --dry-run"},"_npmUser":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com","approver":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}},"_npmVersion":"11.17.0","description":"AI Manager MCP server for AI usage reporting and local diagnostics.","directories":{},"_nodeVersion":"22.22.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ai-manage-tools_0.2.2_1782315382970_0.8632781196266779","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@bangdao-ai/ai-manage-tools","version":"0.2.3","keywords":["ai-manager","usage-reporting","mcp"],"license":"UNLICENSED","_id":"@bangdao-ai/ai-manage-tools@0.2.3","maintainers":[{"name":"baigod","email":"387677341@qq.com"},{"name":"jingli.chang","email":"jingli.chang01@gmail.com"},{"name":"shaoshuai.liu","email":"shaoshuai.liu@bangdao-tech.com"},{"name":"ypsoul","email":"ypsoul94@163.com"},{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}],"bin":{"ai-manage-tools":"bin/ai-manage-tools.mjs"},"dist":{"shasum":"d6d01a93c7cb1368a71f46a5ec323693406f0cbf","tarball":"https://registry.npmjs.org/@bangdao-ai/ai-manage-tools/-/ai-manage-tools-0.2.3.tgz","fileCount":20,"integrity":"sha512-tJDqPuXfPPLnN1rEByLhqHQebi6bqAbtSf8WUYhNy38bqMuwU5zw+46lyYmZVLJoBSoJGWibij26lRXcgzqkIA==","signatures":[{"sig":"MEYCIQDO5Gm/l8Ii1CqKe9wCvAkHExMIKBs53/+YrBOJEBstBAIhAPDaYWjBSc7fAhQjaFPxvp8MW7f2YCaqf+5Mx1yw6vrg","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":100043},"type":"module","engines":{"node":">=18"},"gitHead":"34d1f6a27a93883b194ed5aaa84e9e56f704c7c1","scripts":{"test":"uv run pytest -q && node --test tests/npm-wrapper.test.mjs","publish:npm":"../../script/publish-ai-manage-mcp-npm.sh","pack:dry-run":"npm pack --dry-run","publish:dry-run":"../../script/publish-ai-manage-mcp-npm.sh --dry-run"},"_npmUser":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com","approver":{"name":"cocowangruixue","email":"ruixue.wang@bangdao-tech.com"}},"_npmVersion":"11.17.0","description":"AI Manager MCP server for AI usage reporting and local diagnostics.","directories":{},"_nodeVersion":"22.22.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ai-manage-tools_0.2.3_1782375402941_0.24838738361441193","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-06-22T15:50:56.431Z","modified":"2026-08-28T05:50:14.173Z","0.1.0":"2026-06-22T15:50:56.805Z","0.1.1":"2026-06-22T16:03:31.783Z","0.2.0":"2026-06-23T04:37:54.436Z","0.2.1":"2026-06-23T15:30:29.435Z","0.2.2":"2026-06-24T15:36:23.112Z","0.2.3":"2026-06-25T08:16:43.017Z"},"license":"UNLICENSED","keywords":["ai-manager","usage-reporting","mcp"],"description":"AI Manager MCP server for AI usage reporting and local diagnostics.","maintainers":[{"email":"387677341@qq.com","name":"baigod"},{"email":"jingli.chang01@gmail.com","name":"jingli.chang"},{"email":"shaoshuai.liu@bangdao-tech.com","name":"shaoshuai.liu"},{"email":"ypsoul94@163.com","name":"ypsoul"},{"email":"sunyuanyue@bangdao-tech.com","name":"sunyuanyue"},{"email":"ruixue.wang@bangdao-tech.com","name":"cocowangruixue"},{"email":"ruixuewang2020@163.com","name":"cocowangruixue2"}],"readme":"# ai-manage-tools MCP\n\nAI Manager MCP (Model Context Protocol) tool for AI assistants. It lets Cursor, Codex, Claude Desktop, and other MCP-compatible clients check local configuration and upload AI usage reports to AI Manager.\n\n## Requirements\n\n- Node.js 18+\n- Python 3.11+\n- AI Manager upload token\n\nIf Python is not available as `python3.12`, `python3.11`, or `python3`, set `AI_MANAGE_TOOLS_PYTHON`.\n\n## Install\n\nYou usually do not need to install it globally. Configure your AI tool to run it through `npx`:\n\n```bash\nnpx -y @bangdao-ai/ai-manage-tools@latest\n```\n\n## Environment\n\n```bash\nAI_MANAGER_BASE_URL=https://token.longshine.com/ai-manage\nAI_MANAGER_TOKEN=aim_xxx\n# Optional: disable background collection from the MCP server.\nAI_MANAGER_AUTO_COLLECT=false\n```\n\n- `AI_MANAGER_BASE_URL`: AI Manager service URL.\n- `AI_MANAGER_TOKEN`: upload token issued by AI Manager.\n- `AI_MANAGE_TOOLS_PYTHON`: optional Python interpreter path.\n- `AI_MANAGER_AUTO_COLLECT`: optional. Defaults to enabled; set to `false` to disable background collection.\n- Background collection uses local scheduler and collect locks, so only one `ai-manage-tools` process schedules and runs collection at a time on the same computer.\n\n## Cursor\n\nOpen Cursor MCP settings and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"ai-manage-tools\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bangdao-ai/ai-manage-tools@latest\"],\n      \"env\": {\n        \"AI_MANAGER_BASE_URL\": \"https://token.longshine.com/ai-manage\",\n        \"AI_MANAGER_TOKEN\": \"aim_xxx\"\n      }\n    }\n  }\n}\n```\n\nAfter saving, restart MCP or reload Cursor. Ask the assistant:\n\n```text\n调用 ai-manage-tools 的 status 工具检查连接配置\n```\n\n## Codex\n\nAdd this MCP server to your Codex config:\n\n```toml\n[mcp_servers.ai-manage-tools]\ncommand = \"npx\"\nargs = [\"-y\", \"@bangdao-ai/ai-manage-tools@latest\"]\n\n[mcp_servers.ai-manage-tools.env]\nAI_MANAGER_BASE_URL = \"https://token.longshine.com/ai-manage\"\nAI_MANAGER_TOKEN = \"aim_xxx\"\n```\n\nThen ask Codex to call the `status` tool.\n\n## Claude Desktop\n\nAdd this to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"ai-manage-tools\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bangdao-ai/ai-manage-tools@latest\"],\n      \"env\": {\n        \"AI_MANAGER_BASE_URL\": \"https://token.longshine.com/ai-manage\",\n        \"AI_MANAGER_TOKEN\": \"aim_xxx\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after editing the file.\n\n## Tools\n\n| Tool | Purpose |\n| --- | --- |\n| `status` | Check base URL and whether `AI_MANAGER_TOKEN` is present. |\n| `report` | Upload a local JSONL usage fixture. |\n| `collect` | Collect a bounded local usage batch and upload it. |\n| `doctor` | Run a lightweight local diagnostic. |\n| `backfill` | Run the local backfill entrypoint. |\n\n## CLI fallback\n\nThe package also keeps a direct CLI mode:\n\n```bash\nAI_MANAGER_TOKEN=aim_xxx ai-manage-tools status --base-url https://token.longshine.com/ai-manage\nai-manage-tools report --host codex --fixture ./sample.jsonl --base-url https://token.longshine.com/ai-manage\n```\n\nFor MCP clients, prefer the `npx` configuration above.\n","readmeFilename":"README.md"}