yijing-bazi

name	yijing-bazi
description	Maintain and extend the yijing-bazi MCP server. Use for tasks in this repo such as adding or adjusting MCP tools, engines, data tables, config, logging, tests, or README updates for the 易经/八字 analysis server.

Yijing Bazi

Overview

Maintain the yijing-bazi MCP server codebase. Make changes in src/ (engines, data, utils, config) and update docs/tests to match.

Quick Facts

• Entrypoint: src/index.js
• Engines: src/engines/ (yijing, bazi, combined, knowledge)
• Data: src/data/
• Utils: src/utils/
• Config: src/config/config.js
• Logs: logs/ (created at runtime)

Common Tasks

Add or Change MCP Tools

1. Locate the relevant engine under src/engines/.
2. Add or update the tool handler and its parameter validation.
3. Keep tool names stable; if renaming, update any references and docs.
4. Update README.md tool lists and examples when user-facing behavior changes.

Update Domain Logic or Data

1. Update calculations in src/utils/ or engine logic.
2. Update static tables in src/data/ as needed.
3. Add minimal tests under test/*.test.js if behavior changes are non-trivial.

Config and Runtime Behavior

1. Use src/config/config.js for env handling.
2. If adding env vars, document them in README.md.
3. Prefer existing logging helper in src/utils/logger.js.

Run and Validate

npm install
npm start

npm run dev
npm run lint
npm test