Humanitarian Negotiation MCP Server

# Humanitarian Negotiation MCP Server - File Index ## 📦 Complete Package Contents ### 🚀 Start Here 1. **QUICKSTART.md** (6.6 KB) - 3-minute installation guide - 5-minute first use tutorial - Troubleshooting tips - **→ READ THIS FIRST!** ### 📖 Core Documentation 2. **PROJECT_SUMMARY.md** (12 KB) - Complete project overview - Technical specifications - Methodology summaries - What's included and why 3. **README.md** (11 KB) - Detailed feature documentation - Installation instructions - Methodology deep-dives - Best practices guide 4. **EXAMPLES.md** (18 KB) - Ready-to-use prompts - Complete workflow examples - Real-world scenarios - Tips for effective use ### 💻 Code Files 5. **humanitarian_negotiation_mcp.py** (61 KB) - Main MCP server implementation - 1,800+ lines of Python code - 5 specialized tools - Complete with validation and error handling 6. **setup.py** (6.4 KB) - Automated configuration script - Cross-platform support - Dependency verification - One-command setup 7. **requirements_mcp.txt** (82 bytes) - Python dependencies - Ready for pip install - Version specifications --- ## 🗺️ Navigation Guide ### If you want to... **Get started immediately** → Open **QUICKSTART.md** **Understand what this does** → Open **PROJECT_SUMMARY.md** **Learn the methodologies in depth** → Open **README.md** **See practical examples** → Open **EXAMPLES.md** **Install the server** → Run `python setup.py` **Customize or extend** → Edit **humanitarian_negotiation_mcp.py** --- ## 📋 Three Methodologies Implemented ### 1. Island of Agreement (IoA) **Tool**: `humanitarian_create_island_of_agreement` - Maps contested vs. agreed facts - Identifies convergent vs. divergent norms - Provides strategic recommendations - **Use at**: Start of negotiation ### 2. Iceberg & Common Shared Space (CSS) **Tool**: `humanitarian_analyze_icebergs` - Analyzes WHAT (positions), HOW (reasoning), WHY (motives) - Identifies Common Shared Space - Suggests compromise opportunities - **Use after**: Island of Agreement ### 3. Stakeholder Analysis **Tools**: - `humanitarian_analyze_stakeholders` - `humanitarian_leverage_stakeholder_influence` - Assesses Power, Urgency, Legitimacy, Position - Prioritizes stakeholders - Maps influence pathways - **Use for**: Complex multi-party situations --- ## 🎯 Quick Reference ### Installation (3 minutes) ```bash pip install -r requirements_mcp.txt python setup.py # Restart Claude Desktop ``` ### First Use (5 minutes) ``` Ask Claude: "Use humanitarian_negotiation_guide to show me how to use the negotiation tools" ``` ### File Sizes - Total package: ~115 KB - Main server: 61 KB - Documentation: 48 KB - Configuration: 6.5 KB ### System Requirements - Python 3.10+ - Claude Desktop - 5 MB disk space - All major OS supported (macOS, Windows, Linux) --- ## 📚 Documentation Structure ``` Documentation Hierarchy: ├── QUICKSTART.md ← Start here (fastest path) ├── PROJECT_SUMMARY.md ← Overview (what & why) ├── README.md ← Deep dive (comprehensive) └── EXAMPLES.md ← Practice (hands-on) ``` ### Reading Time Estimates - QUICKSTART.md: 5 minutes - PROJECT_SUMMARY.md: 10 minutes - README.md: 20 minutes - EXAMPLES.md: 15 minutes ### Recommended Reading Order 1. **First time users**: QUICKSTART → EXAMPLES → README 2. **Technical reviewers**: PROJECT_SUMMARY → README → Code 3. **Quick learners**: QUICKSTART → EXAMPLES → Start using 4. **Trainers**: README → EXAMPLES → PROJECT_SUMMARY --- ## 🛠️ Tools Available | Tool Name | Purpose | Input Complexity | Output Format | |-----------|---------|------------------|---------------| | `humanitarian_negotiation_guide` | Get methodology guide | None | Markdown | | `humanitarian_create_island_of_agreement` | Map facts and norms | Medium | Markdown/JSON | | `humanitarian_analyze_icebergs` | Understand motivations | High | Markdown/JSON | | `humanitarian_analyze_stakeholders` | Prioritize actors | High | Markdown/JSON | | `humanitarian_leverage_stakeholder_influence` | Develop tactics | Medium | Markdown/JSON | --- ## ✅ Pre-Flight Checklist Before installation: - [ ] Python 3.10+ installed - [ ] Claude Desktop installed - [ ] pip package manager available - [ ] 5 MB disk space free After installation: - [ ] All dependencies installed - [ ] Server in Claude Desktop config - [ ] Claude Desktop restarted - [ ] 🔌 icon visible in Claude - [ ] Test tool works --- ## 🎓 Learning Path ### Beginner (30 minutes total) 1. Read QUICKSTART.md (5 min) 2. Install server (3 min) 3. Try guide tool (2 min) 4. Run first IoA analysis (10 min) 5. Review EXAMPLES.md (10 min) ### Intermediate (2 hours total) 1. Complete Beginner path (30 min) 2. Read README.md thoroughly (20 min) 3. Try all three methodologies (40 min) 4. Practice with real scenario (30 min) ### Advanced (4 hours total) 1. Complete Intermediate path (2 hours) 2. Study code structure (1 hour) 3. Customize for organization (30 min) 4. Train team members (30 min) --- ## 🔧 Customization Points **Easy** (no coding required): - Change detail level in prompts - Adjust response format preference - Add organization-specific examples **Medium** (basic Python): - Modify CHARACTER_LIMIT - Adjust MAX_STAKEHOLDERS - Customize output templates **Advanced** (Python developer): - Add new analysis tools - Integrate with databases - Implement custom validators - Add organization methodologies --- ## 📞 Getting Help ### Documentation 1. Check QUICKSTART.md troubleshooting section 2. Review EXAMPLES.md for usage patterns 3. Read README.md for methodology details ### In-App Help ``` Ask Claude: "Use humanitarian_negotiation_guide" ``` ### Common Issues - **Connection error**: Check setup.py output - **Invalid input**: Verify parameter ranges - **Poor quality**: Provide more context - **Missing tools**: Restart Claude Desktop --- ## 🚀 Deployment Options ### Individual Use - Run setup.py once - Store files in permanent location - Use directly in Claude Desktop ### Team Use - Share entire directory with team - Each member runs setup.py - Coordinate on customizations - Use shared examples ### Organizational Use - Deploy on shared infrastructure - Customize for org templates - Create org-specific examples - Implement formal training --- ## 📊 Success Metrics You'll know it's working when: - ✅ 🔌 icon appears in Claude Desktop - ✅ Tools appear in Claude's tool list - ✅ First analysis completes successfully - ✅ Output is actionable and relevant - ✅ Team members can use independently --- ## 🎯 Next Steps ### Immediate (Today) 1. Read QUICKSTART.md 2. Run setup.py 3. Test with guide tool ### Short-term (This Week) 1. Try all three methodologies 2. Apply to real negotiation 3. Share with colleagues ### Long-term (This Month) 1. Integrate into workflow 2. Customize for organization 3. Train team members 4. Document lessons learned --- ## 📝 Version History **v1.0.0** (Current) - Complete implementation of all three methodologies - 5 specialized analysis tools - Comprehensive documentation - Automated setup script - Production-ready code --- ## 🏆 Key Features - ✅ Three proven negotiation methodologies - ✅ Professional-grade code quality - ✅ Comprehensive documentation - ✅ Ready-to-use examples - ✅ Automated setup - ✅ Cross-platform support - ✅ Multiple output formats - ✅ Scalable to complex situations - ✅ Built on MCP standards - ✅ Immediate deployment ready --- **This is a complete, production-ready package. Everything you need is included.** **Start with QUICKSTART.md and you'll be running analyses in under 10 minutes!** --- *Last Updated: October 2025* *Package Version: 1.0.0* *Total Files: 7* *Total Size: ~115 KB*