What is Yimcp

Yi Master MCP Server is a tutorial project for implementing the Model Context Protocol (MCP) that incorporates I Ching divination features, allowing users to perform Six Lines (Liuyao) divination through a desktop interface.

Use cases

Use cases include personal divination sessions, educational workshops on AI and divination, development of AI-powered divination applications, and research on integrating traditional practices with modern technology.

How to use

To use Yi Master, clone the repository, build the project using Maven or Gradle, and start the application. You can access the divination service via the Claude Desktop client, a web interface at http://localhost:8080, or through API requests.

Key features

Key features include a tutorial for MCP implementation, a Six Lines I Ching divination system, integration with the Spring.ai framework, compatibility with Claude desktop access, and an interactive divination experience.

Where to use

Yi Master MCP Server can be used in educational settings for learning about AI interactions, in spiritual or wellness applications for divination services, and in software development for integrating AI with traditional practices.

Yi Master MCP Server

Overview

Yi Master MCP Server is a learning tutorial for Model Context Protocol implementation that integrates I Ching divination capabilities. This project demonstrates how to develop AI-powered divination services using Spring.ai and allows users to perform Six Lines (Liuyao) divination through Claude desktop interface.

Features

• Model Context Protocol (MCP) implementation tutorial
• Six Lines (Liuyao) I Ching divination system
• Integration with Spring.ai framework
• Compatible with Claude desktop access
• Interactive divination experience

Prerequisites

• Java Development Kit (JDK 17 or higher)
• Maven or Gradle
• Spring Boot knowledge
• Basic understanding of Spring.ai
• Claude API credentials (for desktop access)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/yimaster-mcp.git
   cd yimaster-mcp
   

2. Build the project:

   ./mvnw clean install
   

Usage

After starting the application, you can access the Yi Master divination service through:

1. Claude Desktop client: Connect to the server endpoint
2. Web interface: Access http://localhost:8080 in your browser
3. API: Send requests to the divination endpoints

Performing Six Lines (Liuyao) Divination

1. Start a new divination session
2. Focus on your question or concern
3. Follow the prompts to generate the six lines
4. Receive and interpret your hexagram reading

Model Context Protocol (MCP) Learning

This project serves as a tutorial for understanding Model Context Protocol:

• How to structure context for AI interactions
• Implementing Spring.ai integrations
• Managing conversation state and context
• Optimizing prompts for divination accuracy

Documentation

Detailed documentation is available in the docs directory:

• API Reference
• YI Basics
• Hexagram Interpretations
• MCP Implementation Guide

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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