Morax/tarot-mcp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: Remove outdated documentation files for CHANGELOG, IMPROVEMENTS, and SPREADS

Browse Source
This commit is contained in:
Morax
2025-07-28 21:26:40 +08:00
parent cfe75ffb2b
commit 0cb4777284
3 changed files with 0 additions and 492 deletions
Download Patch File Download Diff File Expand all files Collapse all files

186
CHANGELOG.md
View File

@@ -1,186 +0,0 @@
# 📝 塔罗牌 MCP 服务器更新日志
## 🎯 版本 1.1.0 - 公平随机性更新 (2025-07-28)
### 🔄 重大改变：正位/逆位分布调整
#### 从 70/30 改为 50/50 分布
**之前 (70/30):**
- 正位牌：70% 概率
- 逆位牌：30% 概率
- 基于传统塔罗牌实践
**现在 (50/50):**
- 正位牌：50% 概率
- 逆位牌：50% 概率
- 完全公平的随机分布
#### 🎯 改变原因
1. **完全公正性**
- 每种方向有相等的概率
- 消除任何潜在的偏差
- 符合现代公平原则
2. **统计准确性**
- 更容易验证随机性
- 简化质量评估算法
- 便于长期统计分析
3. **用户反馈**
- 用户要求更公平的分布
- 避免过度倾向正位解读
- 提供更平衡的占卜体验
#### 🔧 技术实现
```typescript
// 之前的实现
private getSecureRandomOrientation(): CardOrientation {
const random = this.getSecureRandom();
return random < 0.7 ? "upright" : "reversed"; // 70% 正位
}
// 现在的实现
private getSecureRandomOrientation(): CardOrientation {
const random = this.getSecureRandom();
return random < 0.5 ? "upright" : "reversed"; // 50% 正位
}
```
#### 📊 验证工具更新
随机性验证工具 (`verify_randomness`) 已更新：
- 期望正位比例：从 ~70% 改为 ~50%
- 偏差计算：基于50%基准线
- 质量评分：调整评分算法
#### 🧪 测试结果
使用新的50/50分布进行测试：
- ✅ 统计分布更加均匀
- ✅ 验证工具正常工作
- ✅ 占卜结果更加平衡
- ✅ 加密级随机性保持不变
## 🔒 随机性保证系统 (版本 1.0.0)
### ✅ 已实现的功能
1. **加密级随机数生成**
- Web Crypto API / Node.js crypto 模块
- 操作系统级熵源
- 自动降级机制
2. **Fisher-Yates 洗牌算法**
- 数学证明的均匀分布
- O(n) 时间复杂度
- 无统计偏差
3. **13个专业工具**
- 基础塔罗牌工具 (4个)
- 专业牌阵工具 (4个)
- 高级分析工具 (5个)
4. **11种专业牌阵**
- 通用指导牌阵 (4种)
- 关系与个人牌阵 (3种)
- 事业与人生道路牌阵 (2种)
- 灵性与能量工作牌阵 (2种)
5. **随机性验证系统**
- Chi-square 统计检验
- 方向分布验证
- 性能指标分析
- 质量评分系统
## 🎯 使用指南
### 启动服务器
```bash
# HTTP 模式（推荐用于测试）
npm run start:http
# MCP 协议模式（用于 AI 客户端）
npm start
# 开发模式（带热重载）
npm run dev:http
```
### 验证随机性
```bash
# 验证50/50分布
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "verify_randomness",
"arguments": {
"testCount": 100,
"cardCount": 3
}
}
}'
```
### 测试占卜
```bash
# 三张牌占卜
curl -X POST http://localhost:3000/api/reading \
-H "Content-Type: application/json" \
-d '{
"spreadType": "three_card",
"question": "测试50/50分布"
}'
# 关系十字牌阵
curl -X POST http://localhost:3000/api/reading \
-H "Content-Type: application/json" \
-d '{
"spreadType": "relationship_cross",
"question": "如何改善我的人际关系？"
}'
```
## 📚 文档更新
- **RANDOMNESS.md**: 更新了50/50分布说明
- **README.md**: 更新了技术特性描述
- **SPREADS.md**: 完整的牌阵指南
- **CHANGELOG.md**: 本更新日志
## 🔮 质量保证
### 随机性质量标准
- **优秀级别 (90-100分)**: 完全符合50/50分布，统计偏差 < 5%
- **良好级别 (75-89分)**: 轻微偏差，可接受范围内
- **一般级别 (60-74分)**: 存在一些偏差，需要关注
- **差级别 (<60分)**: 显著偏差，需要调查
### 验证指标
1. **方向分布**: 正位/逆位比例接近50/50
2. **卡片分布**: Chi-square 检验确保均匀性
3. **性能指标**: 抽牌速度和算法效率
4. **熵值计算**: 真实随机性验证
## 🎉 总结
这次更新将塔罗牌方向分布从70/30调整为50/50，提供了：
- ✅ **完全公正的随机性**：每种方向概率相等
- ✅ **更好的统计特性**：便于验证和测试
- ✅ **现代化设计**：符合公平原则
- ✅ **保持专业品质**：加密级随机性不变
- ✅ **全面的验证工具**：确保质量可控
现在您的塔罗牌占卜系统提供了真正公正、统计学上可验证的随机性保证！🔮✨

152
IMPROVEMENTS.md
View File

@@ -1,152 +0,0 @@
# 🔮 Tarot MCP Server - Improvements & Research Summary
## 📚 Research-Based Improvements
### Professional Tarot Reading Methods Implemented
Based on extensive research from professional tarot sources including Biddy Tarot, Labyrinthos, and traditional tarot literature, the following improvements have been implemented:
#### 1. **Enhanced Celtic Cross Analysis**
- **Position Relationships**: Implemented analysis of key card relationships (Above vs Below, Goal vs Outcome, Future vs Outcome)
- **Conscious vs Subconscious**: Added interpretation of the vertical axis representing consciousness levels
- **Time Flow Analysis**: Enhanced horizontal axis interpretation showing past-present-future progression
- **Cross Dynamics**: Proper analysis of the central cross (heart of the matter) vs outer cross (broader context)
#### 2. **Advanced Card Combination Interpretation**
- **Elemental Balance**: Analysis of Fire, Water, Air, Earth distribution and missing elements
- **Suit Patterns**: Deep analysis of Wands (action), Cups (emotion), Swords (thought), Pentacles (material)
- **Numerical Progression**: Interpretation based on card numbers and their spiritual significance
- **Court Card Influence**: Recognition of personality aspects and people in readings
- **Major Arcana Patterns**: Archetypal analysis and Fool's Journey progression
#### 3. **Context-Aware Interpretations**
- **Question-Based Meaning Selection**: Automatically selects most relevant meaning (love, career, health, spiritual) based on question content
- **Position-Specific Interpretations**: Tailored meanings based on card position in spread
- **Spread-Specific Analysis**: Different analytical approaches for Celtic Cross vs Three Card vs Single Card readings
#### 4. **Professional Reading Structure**
- **Energy Assessment**: Analysis of upright vs reversed card ratios
- **Major vs Minor Arcana Balance**: Interpretation of spiritual vs practical influences
- **Flow Analysis**: For three-card spreads, analysis of energy progression
- **Holistic Integration**: Combining individual card meanings with overall reading themes
## 🃏 Enhanced Tarot Card Database
### Completed Cards (Research-Verified)
- **Major Arcana**: 9 cards completed with full symbolism, astrology, and numerology
- The Fool, The Magician, The High Priestess, The Empress, The Emperor, The Hierophant, The Lovers, The Chariot, Strength, The Hermit
- **Minor Arcana Wands**: 5 cards with detailed fire element interpretations
- **Minor Arcana Cups**: 3 cards with water element and emotional themes
- **Minor Arcana Swords**: 2 cards with air element and mental themes
- **Minor Arcana Pentacles**: 1 card with earth element and material themes
### Card Data Accuracy Improvements
- **Astrological Correspondences**: Added proper planetary and zodiacal associations
- **Elemental Associations**: Correct elemental attributions for each suit and major arcana
- **Numerological Significance**: Detailed numerological meanings for each number
- **Symbolism Analysis**: Comprehensive symbol interpretation based on Rider-Waite imagery
- **Reversed Meanings**: Nuanced reversed interpretations beyond simple opposites
## 🔧 Technical Improvements
### Advanced Interpretation Engine
```typescript
// New features implemented:
- generateAdvancedCombinationInterpretation()
- analyzeElements() & interpretElementalBalance()
- analyzeSuits() & analyzeNumericalPatterns()
- analyzeCourtCards() & analyzeMajorArcanaPatterns()
- generateCelticCrossAnalysis() & generateThreeCardAnalysis()
```
### Professional Reading Methods
- **Celtic Cross Dynamics**: Proper analysis of card relationships and cross structure
- **Three Card Flow**: Energy progression analysis from past through future
- **Elemental Balance**: Missing element identification and recommendations
- **Archetypal Patterns**: Recognition of spiritual themes and life lessons
## 🎯 Accuracy Validation
### Research Sources Consulted
1. **Biddy Tarot**: Professional Celtic Cross methodology and card meanings
2. **Labyrinthos**: Traditional Rider-Waite symbolism and interpretations
3. **Classical Tarot Literature**: Traditional meanings and correspondences
4. **Professional Reader Techniques**: Advanced combination interpretation methods
### Validation Methods
- **Cross-Reference**: Multiple source verification for each card meaning
- **Traditional Accuracy**: Adherence to established Rider-Waite traditions
- **Professional Standards**: Implementation of methods used by certified readers
- **Symbolic Integrity**: Proper interpretation of traditional symbols and imagery
## 🚀 Performance & Deployment Improvements
### HTTP Server Enhancements
- **Multiple Transport Support**: stdio, HTTP, SSE protocols
- **RESTful API**: Direct endpoints for easy integration
- **CORS Support**: Cross-origin resource sharing for web applications
- **Error Handling**: Comprehensive error responses and logging
### Production Readiness
- **Docker Support**: Complete containerization with health checks
- **Docker Compose**: Multi-service deployment configuration
- **Deployment Scripts**: Automated deployment with health validation
- **Environment Configuration**: Flexible configuration for different environments
## 📊 Testing & Quality Assurance
### Test Coverage
- **Unit Tests**: Card manager functionality testing
- **Integration Tests**: Reading generation and interpretation testing
- **API Tests**: HTTP endpoint validation
- **Type Safety**: Full TypeScript implementation with strict typing
### Quality Metrics
- **Code Coverage**: Comprehensive test coverage for core functionality
- **Type Safety**: 100% TypeScript with strict mode enabled
- **Error Handling**: Graceful error handling and user feedback
- **Performance**: Optimized for fast reading generation
## 🔮 Professional Reading Features
### Advanced Spread Analysis
- **Celtic Cross**: 10-card comprehensive life analysis
- **Three Card**: Past/Present/Future with flow analysis
- **Single Card**: Daily guidance with elemental context
### Interpretation Depth
- **Multi-Layered Analysis**: Individual cards + combinations + overall themes
- **Context Awareness**: Question-specific meaning selection
- **Professional Language**: Authentic tarot terminology and phrasing
- **Actionable Guidance**: Practical advice and spiritual insights
## 🌟 Future Enhancements
### Planned Improvements
1. **Complete Deck**: All 78 cards with full interpretations
2. **Additional Spreads**: Relationship, Career, Spiritual spreads
3. **Advanced Timing**: Seasonal and timing predictions
4. **Card Imagery**: Integration with visual card representations
5. **Reading History**: Enhanced session management and reading tracking
### Research Areas
- **Psychological Tarot**: Jungian and psychological interpretation methods
- **Cultural Variations**: Different tarot traditions and interpretations
- **Modern Applications**: Contemporary life situations and guidance
- **AI Enhancement**: Machine learning for pattern recognition in readings
## 📈 Impact & Results
### Professional Quality
- **Authentic Interpretations**: Research-based, traditional meanings
- **Comprehensive Analysis**: Multi-dimensional reading approach
- **User Experience**: Clear, insightful, actionable guidance
- **Technical Excellence**: Production-ready, scalable architecture
### Validation Results
- **Accuracy**: Verified against professional tarot standards
- **Completeness**: Comprehensive coverage of major tarot concepts
- **Usability**: Easy integration with MCP clients and direct API access
- **Reliability**: Robust error handling and consistent performance
This enhanced Tarot MCP Server now provides professional-quality tarot readings with research-verified accuracy and comprehensive interpretation capabilities.

154
SPREADS.md
View File

@@ -1,154 +0,0 @@
# 🎯 Professional Tarot Spreads Guide
## Overview
The Tarot MCP Server features **11 specialized tarot spreads** designed for different life areas and spiritual practices. Each spread includes professional interpretation methods, position dynamics analysis, and specialized guidance.
## 🔮 General Guidance Spreads
### Single Card (1 card)
**Purpose**: Daily guidance and quick insights
**Best for**: Daily questions, simple yes/no guidance, immediate clarity
**Analysis**: Elemental context, spiritual significance, actionable guidance
### Three Card Spread (3 cards)
**Purpose**: Past/Present/Future analysis with energy flow
**Positions**: Past/Situation → Present/Action → Future/Outcome
**Analysis**: Energy progression, temporal flow, decision guidance
**Best for**: Understanding life transitions, decision outcomes
### Celtic Cross (10 cards)
**Purpose**: Comprehensive life analysis
**Positions**: Present, Challenge, Foundation, Past, Outcome, Future, Self, External, Hopes/Fears, Final Outcome
**Analysis**: Position dynamics, conscious vs subconscious, goal vs outcome relationships
**Best for**: Major life questions, comprehensive situation analysis
### Horseshoe Spread (7 cards)
**Purpose**: Situation guidance with obstacles and advice
**Positions**: Past Influences, Present, Hidden Influences, Obstacles, External Influences, Advice, Outcome
**Analysis**: Hidden factor identification, obstacle navigation, strategic guidance
**Best for**: Complex situations requiring strategic planning
## 💕 Relationships & Personal Spreads
### Relationship Cross (7 cards)
**Purpose**: Relationship dynamics analysis
**Positions**: You, Partner, Relationship, What Unites, What Divides, Advice, Future Potential
**Analysis**: Compatibility assessment, unity/division dynamics, relationship energy balance
**Best for**: Romantic relationships, friendships, family dynamics
### Decision Making Spread (5 cards)
**Purpose**: Choice evaluation and guidance
**Positions**: Situation, Option A, Option B, What You Need to Know, Recommended Path
**Analysis**: Comparative analysis, hidden factors, optimal choice identification
**Best for**: Important life decisions, career choices, relationship decisions
### Shadow Work Spread (5 cards)
**Purpose**: Psychological integration and growth
**Positions**: Your Shadow, How It Manifests, The Gift Within, Integration Process, Transformation
**Analysis**: Psychological patterns, integration guidance, personal growth insights
**Best for**: Self-development, therapy support, personal healing
## 🚀 Career & Life Path Spreads
### Career Path Spread (6 cards)
**Purpose**: Professional development guidance
**Positions**: Current Situation, Skills/Talents, Challenges, Hidden Opportunities, Action to Take, Outcome
**Analysis**: Career readiness assessment, skill evaluation, opportunity identification
**Best for**: Career transitions, professional development, job searching
### Year Ahead Spread (13 cards)
**Purpose**: Annual forecast with monthly insights
**Positions**: Overall Theme + 12 monthly cards (January through December)
**Analysis**: Seasonal patterns, quarterly energy assessment, annual theme integration
**Best for**: New Year planning, annual goal setting, life planning
## 🧘 Spiritual & Energy Work Spreads
### Spiritual Guidance Spread (6 cards)
**Purpose**: Spiritual development and higher self connection
**Positions**: Spiritual State, Lessons, Blocks to Growth, Spiritual Gifts, Guidance from Above, Next Steps
**Analysis**: Spiritual progress assessment, gift identification, development guidance
**Best for**: Spiritual seeking, meditation practice, personal awakening
### Chakra Alignment Spread (7 cards)
**Purpose**: Energy center analysis and healing
**Positions**: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown Chakras
**Analysis**: Energy balance assessment, chakra health evaluation, healing guidance
**Best for**: Energy healing, meditation practice, holistic wellness
## 🔧 Advanced Analysis Features
### Specialized Interpretation Methods
Each spread type includes tailored analysis:
- **Position Dynamics**: Understanding relationships between card positions
- **Energy Flow Assessment**: Tracking energy movement through the spread
- **Context-Aware Meanings**: Selecting relevant interpretations based on spread purpose
- **Elemental Balance**: Analyzing Fire, Water, Air, Earth distribution
- **Numerical Patterns**: Identifying spiritual significance in card numbers
### Professional Reading Structure
1. **Individual Card Analysis**: Position-specific interpretations
2. **Spread-Specific Analysis**: Tailored to spread type and purpose
3. **Overall Energy Assessment**: Holistic reading evaluation
4. **Actionable Guidance**: Practical steps and spiritual insights
## 📊 Usage Statistics & Recommendations
### Most Popular Spreads
1. **Celtic Cross** - Comprehensive life analysis
2. **Three Card** - Quick decision guidance
3. **Relationship Cross** - Relationship insights
4. **Career Path** - Professional guidance
5. **Single Card** - Daily guidance
### Recommended Spread Selection
- **Daily Practice**: Single Card
- **Relationship Questions**: Relationship Cross
- **Career Decisions**: Career Path Spread
- **Life Transitions**: Celtic Cross
- **Spiritual Growth**: Spiritual Guidance or Chakra Alignment
- **Important Decisions**: Decision Making Spread
- **Annual Planning**: Year Ahead Spread
## 🎯 API Usage Examples
### List All Available Spreads
```bash
curl http://localhost:3000/api/spreads
```
### Perform Specific Spread Reading
```bash
curl -X POST http://localhost:3000/api/reading \
-H "Content-Type: application/json" \
-d '{
"spreadType": "relationship_cross",
"question": "How can I improve my relationship?",
"sessionId": "optional-session-id"
}'
```
### Available Spread Types
- `single_card`
- `three_card`
- `celtic_cross`
- `horseshoe`
- `relationship_cross`
- `career_path`
- `decision_making`
- `spiritual_guidance`
- `year_ahead`
- `chakra_alignment`
- `shadow_work`
## 🔮 Professional Quality Assurance
All spreads are designed with:
- **Traditional Accuracy**: Based on established tarot practices
- **Professional Methods**: Verified against expert sources
- **Comprehensive Analysis**: Multi-dimensional interpretation
- **Practical Guidance**: Actionable insights and spiritual wisdom
- **Flexible Application**: Suitable for various question types and life situations
This comprehensive spread system provides professional-quality tarot readings for every aspect of life and spiritual development.