WMS Public API Generate Helper (MCP)

Doc-only MCP server for project-level API integration. It exposes a single tool that returns OpenAPI snippets plus a strict prompt that forbids MCP/tool calls in production code.

Features

• Stdio-only MCP server (no CLI)
• Single tool: api_dev_doc
• api://docs resource for full OpenAPI
• Optional OpenAPI sync script

Usage (stdio JSON-RPC)

Initialize:

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","clientInfo":{"name":"agent","version":"1.0.0"}}}

List tools:

{"jsonrpc":"2.0","id":2,"method":"tools/list"}

Call doc tool:

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"api_dev_doc","arguments":{"name":"post_v1_public_user_login","language":"zh"}}}

Read OpenAPI:

{"jsonrpc":"2.0","id":4,"method":"resources/read","params":{"uri":"api://docs"}}

OpenAPI sync

npm run sync:api

Environment:

• APIFOX_OPENAPI_URL (default: http://127.0.0.1:4523/export/openapi/2?version=3.0)
• APIFOX_OPENAPI_FILE
• OPENAPI_OUTPUT_PATH (default: openapi.yaml)
• OPENAPI_SNAPSHOT_PATH (default: api/openapi.apifox.yaml)

Notes

• The tool returns a strict prompt to generate real HTTP code (no MCP tool calls).
• APIFOX_PATH_PREFIX can filter the OpenAPI paths if needed (default: /v1/public/).