HLY_MCP

HLY_MCP is an MCP server for HLY (HuiLianYi) expense report operations.

It currently supports:

• querying expense report detail
• creating expense reports
• querying companies by tenant
• querying expense reports v2 with receipt expansion
• audit-pass expense reports
• audit-reject expense reports
• local third-party info storage helpers

Package Name

The npm package name is:

@azhena/hly-mcp

The installed CLI commands are:

HLY_MCP
hly-mcp

Install

Global install:

npm install -g @azhena/hly-mcp

Run directly after install:

HLY_MCP

Or:

hly-mcp

Environment Variables

Required:

• HLY_BASE_URL
• HLY_APP_ID
• HLY_APP_SECRET

Optional:

• HLY_TOKEN_PATH default: /oauth/token
• HLY_EXPENSE_DETAIL_PATH default: /api/open/expenseReport/detail
• HLY_EXPENSE_CREATE_PATH default: /api/open/expenseReport/create
• HLY_EXPENSE_REPORT_V2_PATH default: /api/open/expenseReport/v2
• HLY_EXPENSE_AUDIT_PASS_PATH default: /api/open/expenseReport/audit/pass
• HLY_EXPENSE_AUDIT_REJECT_PATH default: /api/open/expenseReport/audit/reject
• HLY_COMPANY_BY_TENANT_PATH default: /api/open/company/tenant/all
• HLY_TIMEOUT_MS default: 30000
• HLY_RETRY_COUNT default: 1
• HLY_CACHE_TTL_SECONDS default: 86400
• HLY_EXPENSE_DETAIL_CACHE_PATH
• HLY_HTTP_DEBUG set to 1 to print HTTP request/response logs

Recommended HLY gateway base URLs:

• PROD: https://api.huilianyi.com/gateway
• STAGE: https://apistage.huilianyi.com/gateway
• SANDBOX: https://huoshantstapi.huilianyi.com/gateway

MCP Client Config

Example MCP client config:

{
  "mcpServers": {
    "HLY_MCP": {
      "command": "hly-mcp",
      "env": {
        "HLY_BASE_URL": "https://apistage.huilianyi.com/gateway",
        "HLY_APP_ID": "your_app_id",
        "HLY_APP_SECRET": "your_app_secret"
      }
    }
  }
}

If your client does not use global binaries, you can also run with npx:

{
  "mcpServers": {
    "HLY_MCP": {
      "command": "npx",
      "args": [
        "-y",
        "@azhena/hly-mcp"
      ],
      "env": {
        "HLY_BASE_URL": "https://apistage.huilianyi.com/gateway",
        "HLY_APP_ID": "your_app_id",
        "HLY_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Local Development

Clone the project:

git clone <your-repo-url>
cd huilianyi-third-info-mcp

Install dependencies:

npm install

Create local env config:

cp .env.example .env

If you are on Windows and cp is unavailable, create .env manually and fill in:

HLY_BASE_URL=https://apistage.huilianyi.com/gateway
HLY_APP_ID=your_app_id
HLY_APP_SECRET=your_app_secret

Start locally:

npm start

Or run directly:

node src/index.js

Use local source in an MCP client:

{
  "mcpServers": {
    "HLY_MCP": {
      "command": "node",
      "args": [
        "C:/path/to/huilianyi-third-info-mcp/src/index.js"
      ],
      "env": {
        "HLY_BASE_URL": "https://apistage.huilianyi.com/gateway",
        "HLY_APP_ID": "your_app_id",
        "HLY_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Install dependencies:

npm install

Start locally:

npm start

Run tests:

npm test

Preview the publish tarball:

npm pack

Main Tools

• query_expense_report_detail
• create_expense_report
• query_companies_by_tenant
• query_expense_reports_v2
• audit_pass_expense_report
• audit_reject_expense_report
• upsert_expense_third_info
• get_expense_third_info_by_business_code
• list_expense_third_info_by_employee
• search_expense_third_info

Publish

Log in with your npm account:

npm login

Publish the package:

npm publish