{"_id":"@azhena/hly-mcp","_rev":"2-c05c757fb8489443e7671bad8ee7a121","name":"@azhena/hly-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@azhena/hly-mcp","version":"0.1.0","keywords":["mcp","hly","huilianyi","expense","finance"],"author":{"name":"azhena"},"license":"MIT","_id":"@azhena/hly-mcp@0.1.0","maintainers":[{"name":"azhena","email":"15939054361@163.com"}],"bin":{"HLY_MCP":"src/index.js","hly-mcp":"src/index.js"},"dist":{"shasum":"ae9b5435224a33a0beaa24302132d7db18303026","tarball":"https://registry.npmjs.org/@azhena/hly-mcp/-/hly-mcp-0.1.0.tgz","fileCount":13,"integrity":"sha512-ijenrK0v1IckpdRcisl8EYbMmzy2pg2pmn5lIxlZ1coQkz/v6OWKEc641A1vFszpZKp31NUSXqCuyLmJo+qaVg==","signatures":[{"sig":"MEQCIDL4STDH9KTy5pcGfvfFGWEoR+KMQocavb5K+bX8tGLNAiBxke5UX+XH6vgbpKmtaqLlz0ZoByKgEi5B4AEbY6GfJA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40314},"main":"src/index.js","type":"module","engines":{"node":"^20.0.0 || ^22.0.0"},"gitHead":"dc187e7a77e622a88d510dc537cfb032a90ee42b","scripts":{"test":"node --test","start":"node src/index.js"},"_npmUser":{"name":"azhena","email":"15939054361@163.com"},"_npmVersion":"11.7.0","description":"MCP server for querying and operating HLY expense reports and related data","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^3.23.8","dotenv":"^16.6.1","@modelcontextprotocol/sdk":"^1.17.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/hly-mcp_0.1.0_1775036887656_0.49432171894081844","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@azhena/hly-mcp","version":"0.1.1","description":"MCP server for querying and operating HLY expense reports and related data","type":"module","main":"src/index.js","bin":{"hly-mcp":"bin/index.js"},"scripts":{"start":"node src/index.js","test":"node --test"},"publishConfig":{"access":"public"},"author":{"name":"azhena"},"license":"MIT","keywords":["mcp","hly","huilianyi","expense","finance"],"dependencies":{"@modelcontextprotocol/sdk":"^1.17.0","dotenv":"^16.6.1","undici":"^7.13.0","zod":"^3.23.8"},"engines":{"node":"^20.0.0 || ^22.0.0"},"gitHead":"dc187e7a77e622a88d510dc537cfb032a90ee42b","_id":"@azhena/hly-mcp@0.1.1","_nodeVersion":"22.22.1","_npmVersion":"11.7.0","dist":{"integrity":"sha512-gTQyAGHILHRo8ApSHJlbRWYEoXG0FazmUADXBAj+G4G0qa0taUp6uYO6NTTV9i/yGDzCGx0VsY6FXS2Ae8YLbA==","shasum":"dce09a89a7dbfd4855282f5d72415affa061174b","tarball":"https://registry.npmjs.org/@azhena/hly-mcp/-/hly-mcp-0.1.1.tgz","fileCount":15,"unpackedSize":40648,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCkrzrq0rI92D7djtvhiJp4BB4+NwIA4HMw0Y6kGn1P1AIgRYAPeQ3yDRxaw43o/26sapNepoCidgYfzPwkUKAwiS0="}]},"_npmUser":{"name":"azhena","email":"15939054361@163.com"},"directories":{},"maintainers":[{"name":"azhena","email":"15939054361@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hly-mcp_0.1.1_1775038175538_0.6845149173745393"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T09:48:07.507Z","modified":"2026-04-01T10:09:35.830Z","0.1.0":"2026-04-01T09:48:07.828Z","0.1.1":"2026-04-01T10:09:35.718Z"},"author":{"name":"azhena"},"license":"MIT","keywords":["mcp","hly","huilianyi","expense","finance"],"description":"MCP server for querying and operating HLY expense reports and related data","maintainers":[{"name":"azhena","email":"15939054361@163.com"}],"readme":"# HLY_MCP\n\n`HLY_MCP` is an MCP server for HLY (HuiLianYi) expense report operations.\n\nIt currently supports:\n\n- querying expense report detail\n- creating expense reports\n- querying companies by tenant\n- querying expense reports v2 with receipt expansion\n- audit-pass expense reports\n- audit-reject expense reports\n- local third-party info storage helpers\n\n## Package Name\n\nThe npm package name is:\n\n```bash\n@azhena/hly-mcp\n```\n\nThe installed CLI commands are:\n\n```bash\nHLY_MCP\nhly-mcp\n```\n\n## Install\n\nGlobal install:\n\n```bash\nnpm install -g @azhena/hly-mcp\n```\n\nRun directly after install:\n\n```bash\nHLY_MCP\n```\n\nOr:\n\n```bash\nhly-mcp\n```\n\n## Environment Variables\n\nRequired:\n\n- `HLY_BASE_URL`\n- `HLY_APP_ID`\n- `HLY_APP_SECRET`\n\nOptional:\n\n- `HLY_TOKEN_PATH` default: `/oauth/token`\n- `HLY_EXPENSE_DETAIL_PATH` default: `/api/open/expenseReport/detail`\n- `HLY_EXPENSE_CREATE_PATH` default: `/api/open/expenseReport/create`\n- `HLY_EXPENSE_REPORT_V2_PATH` default: `/api/open/expenseReport/v2`\n- `HLY_EXPENSE_AUDIT_PASS_PATH` default: `/api/open/expenseReport/audit/pass`\n- `HLY_EXPENSE_AUDIT_REJECT_PATH` default: `/api/open/expenseReport/audit/reject`\n- `HLY_COMPANY_BY_TENANT_PATH` default: `/api/open/company/tenant/all`\n- `HLY_TIMEOUT_MS` default: `30000`\n- `HLY_RETRY_COUNT` default: `1`\n- `HLY_CACHE_TTL_SECONDS` default: `86400`\n- `HLY_EXPENSE_DETAIL_CACHE_PATH`\n- `HLY_HTTP_DEBUG` set to `1` to print HTTP request/response logs\n\nRecommended HLY gateway base URLs:\n\n- PROD: `https://api.huilianyi.com/gateway`\n- STAGE: `https://apistage.huilianyi.com/gateway`\n- SANDBOX: `https://huoshantstapi.huilianyi.com/gateway`\n\n## MCP Client Config\n\nExample MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"HLY_MCP\": {\n      \"command\": \"hly-mcp\",\n      \"env\": {\n        \"HLY_BASE_URL\": \"https://apistage.huilianyi.com/gateway\",\n        \"HLY_APP_ID\": \"your_app_id\",\n        \"HLY_APP_SECRET\": \"your_app_secret\"\n      }\n    }\n  }\n}\n```\n\nIf your client does not use global binaries, you can also run with `npx`:\n\n```json\n{\n  \"mcpServers\": {\n    \"HLY_MCP\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@azhena/hly-mcp\"\n      ],\n      \"env\": {\n        \"HLY_BASE_URL\": \"https://apistage.huilianyi.com/gateway\",\n        \"HLY_APP_ID\": \"your_app_id\",\n        \"HLY_APP_SECRET\": \"your_app_secret\"\n      }\n    }\n  }\n}\n```\n\n## Local Development\n\nClone the project:\n\n```bash\ngit clone <your-repo-url>\ncd huilianyi-third-info-mcp\n```\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nCreate local env config:\n\n```bash\ncp .env.example .env\n```\n\nIf you are on Windows and `cp` is unavailable, create `.env` manually and fill in:\n\n```env\nHLY_BASE_URL=https://apistage.huilianyi.com/gateway\nHLY_APP_ID=your_app_id\nHLY_APP_SECRET=your_app_secret\n```\n\nStart locally:\n\n```bash\nnpm start\n```\n\nOr run directly:\n\n```bash\nnode src/index.js\n```\n\nUse local source in an MCP client:\n\n```json\n{\n  \"mcpServers\": {\n    \"HLY_MCP\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"C:/path/to/huilianyi-third-info-mcp/src/index.js\"\n      ],\n      \"env\": {\n        \"HLY_BASE_URL\": \"https://apistage.huilianyi.com/gateway\",\n        \"HLY_APP_ID\": \"your_app_id\",\n        \"HLY_APP_SECRET\": \"your_app_secret\"\n      }\n    }\n  }\n}\n```\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nStart locally:\n\n```bash\nnpm start\n```\n\nRun tests:\n\n```bash\nnpm test\n```\n\nPreview the publish tarball:\n\n```bash\nnpm pack\n```\n\n## Main Tools\n\n- `query_expense_report_detail`\n- `create_expense_report`\n- `query_companies_by_tenant`\n- `query_expense_reports_v2`\n- `audit_pass_expense_report`\n- `audit_reject_expense_report`\n- `upsert_expense_third_info`\n- `get_expense_third_info_by_business_code`\n- `list_expense_third_info_by_employee`\n- `search_expense_third_info`\n\n## Publish\n\nLog in with your npm account:\n\n```bash\nnpm login\n```\n\nPublish the package:\n\n```bash\nnpm publish\n```\n","readmeFilename":"README.md"}