Mcpiztro

🚀 Ziwei Dou Shu MCP Server

A Ziwei Dou Shu calculation server based on Model Context Protocol (MCP), leveraging the powerful iztro library to provide accurate Ziwei Dou Shu chart calculation and fortune analysis.

🚀 Quick Start

This Ziwei Dou Shu MCP server offers a wide range of features for calculating Ziwei Dou Shu charts and analyzing fortunes. Follow the installation and configuration steps below to get started.

✨ Features

• 🌟 Complete Ziwei Dou Shu Chart Calculation - Supports calculations based on both Gregorian and Lunar birthdays.
• 📅 Precise Time Handling - Obtain the current system time and detailed information.
• 🔮 Fortune Analysis - Analyze fortunes such as major cycles and annual fortunes.
• 🌐 Multilingual Support - Supports Simplified Chinese, Traditional Chinese, English, Japanese, Korean, and Vietnamese.
• 🔄 MCP Protocol Compatibility - Seamlessly integrate with AI assistants supporting the MCP protocol.
• ⚡ Lightweight and Efficient - Based on Node.js, providing fast responses.
• 📊 Structured Data - Return complete star chart data in JSON format.

🛠️ Technical Stack

📦 Installation

Prerequisites

• Node.js 18.0.0 or higher
• npm package manager

Clone the Repository

git clone https://github.com/wuunicorn/MCPIztro.git
cd MCPIztro

Install Dependencies

npm install

⚙️ Configuration

1. Create a Configuration File

Modify the paths in ziwei_mcp_config.json to your actual project paths:

{
  "mcpServers": {
    "ziwei": {
      "command": "node",
      "args": ["/path/to/your/project/ziwei_mcp_server.js"],
      "env": {
        "NODE_PATH": "/path/to/your/project/node_modules"
      }
    }
  }
}

2. Configure in the MCP Client

Add the configuration file content to your MCP client configuration (e.g., Claude Desktop, Cursor).

💻 Usage Examples

Basic Usage

Start the Server

npm start
# or
node ziwei_mcp_server.js

Run Tests

npm test
# or
node test_ziwei.js

Advanced Usage

Use in the MCP Client

After configuration, you can use natural language queries directly in MCP-supported clients:

Please calculate the Ziwei Dou Shu chart for a female born at 2 PM on August 16, 1990.

I want to see this person's fortune in 2024.

Direct API Calls

# Get the current time
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_current_time", "arguments": {}}}' | node ziwei_mcp_server.js

# Calculate the star chart
echo '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "calculate_ziwei", "arguments": {"birthday": "1990-08-16", "hour": 14, "gender": "female"}}}' | node ziwei_mcp_server.js

📚 Documentation

API Documentation

The server provides the following three main tools:

1. get_current_time

Get detailed information about the current system time.

• Parameters: None
• Return:

{
  "success": true,
  "data": {
    "year": 2024,
    "month": 8,
    "day": 1,
    "hour": 15,
    "minute": 30,
    "second": 45,
    "datetime_str": "2024-08-01 15:30:45",
    "weekday": "Thursday",
    "weekday_cn": "Thursday",
    "timestamp": 1722513045
  }
}

2. calculate_ziwei

Calculate the Ziwei Dou Shu star chart for a specified birth date.

• Parameters:
  • birthday (required): Birth date in the format YYYY-MM-DD.
  • hour (optional): Birth hour (0-23), default is 0.
  • gender (optional): Gender ("male"/"female"), default is "male".
  • type (optional): Date type ("solar"/"lunar"), default is "solar".
  • isLeapMonth (optional): Whether it is a leap month, default is false.
  • language (optional): Language setting, default is "zh-CN".
• Example Request:

{
  "birthday": "1990-08-16",
  "hour": 14,
  "gender": "female",
  "type": "solar",
  "language": "zh-CN"
}

• Return: Complete star chart data, including information about the twelve palaces, star distributions, and brightness.

3. get_horoscope

Get the fortune information for a specified birth date at a specific time.

• Parameters:
  • birthday (required): Birth date in the format YYYY-MM-DD.
  • hour (optional): Birth hour (0-23), default is 0.
  • gender (optional): Gender ("male"/"female"), default is "male".
  • type (optional): Date type ("solar"/"lunar"), default is "solar".
  • isLeapMonth (optional): Whether it is a leap month, default is false.
  • targetDate (optional): Target date in the format YYYY-MM-DD, default is the current date.
  • language (optional): Language setting, default is "zh-CN".
• Return: Fortune information, including major cycles, annual fortunes, and age data.

Supported Languages

🔧 Technical Details

Project Structure

MCPIztro/
├── README.md                 # Project introduction document
├── package.json             # Project configuration and dependencies
├── package-lock.json        # Dependency lock file
├── ziwei_mcp_server.js      # MCP server main program
├── ziwei_mcp_config.json    # MCP configuration file template
├── test_ziwei.js           # Test script
└── node_modules/           # Dependency package directory

Development

Test Server Functionality

node test_ziwei.js

Check Syntax

node -c ziwei_mcp_server.js

Verify Dependencies

node -e "import { astro } from 'iztro'; console.log('Dependencies loaded successfully');"

🤝 Contribution

We welcome you to submit issues and pull requests!

1. Fork this repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a pull request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• iztro - Provides powerful Ziwei Dou Shu calculation capabilities.
• Model Context Protocol - Provides standardized protocol support.

📞 Contact

If you have any questions or suggestions, please contact us in the following ways:

• Submit an Issue.
• Send an email to: wuunicorn@gmail.com

⚠️ Important Note

Ziwei Dou Shu is for reference and entertainment purposes only. Please treat the fortune analysis results rationally.