ThoughtMCP

# ThoughtMCP Examples This section contains examples showing how to use ThoughtMCP in real-world scenarios. Examples are organized from simple to complex. ## Quick Navigation ### 🚀 Basic Examples Perfect for learning the fundamentals: - **[Simple Question Answering](basic/simple-qa.md)** - Basic think tool usage - **[Building Knowledge](basic/building-knowledge.md)** - Using remember and recall - **[Quality Checking](basic/quality-checking.md)** - Using analyze_reasoning - **[Advanced Cognitive Tools](basic/advanced-tools.md)** - Systematic analysis, parallel reasoning, and memory management - **[Complete Workflow](basic/complete-workflow.md)** - All tools together ### 🏢 Real-World Scenarios Complex applications demonstrating full capabilities: - **[Customer Support Agent](real-world/customer-support.md)** - Technical problem solving - **[Personal Finance Advisor](real-world/finance-advisor.md)** - Financial decision making - **[Recipe Recommendation](real-world/recipe-recommendation.md)** - Personalized suggestions - **[Study Buddy](real-world/study-buddy.md)** - Educational assistance - **[Travel Planning](real-world/travel-planner.md)** - Complex planning scenarios ### 🔧 Integration Examples How to integrate ThoughtMCP into applications: - **[Node.js Integration](integration/nodejs.md)** - Server-side integration - **[Python Client](integration/python.md)** - Python MCP client - **[Web Application](integration/web-app.md)** - Browser-based usage - **[CLI Tool](integration/cli.md)** - Command-line interface ## How to Use These Examples ### For Beginners Start with **Basic Examples** to understand each tool: 1. Read the scenario description 2. Try the example tool calls 3. Understand what each tool contributes 4. Experiment with variations ### For Developers Focus on **Integration Examples** to see implementation patterns: 1. Review the code structure 2. Understand the MCP protocol usage 3. Adapt patterns to your use case 4. Check error handling approaches ### For Advanced Users Study **Real-World Scenarios** to see complex workflows: 1. Analyze the problem-solving approach 2. See how tools work together 3. Understand the cognitive benefits 4. Apply patterns to your domain ## Example Format Each example follows this structure: ### The Problem Clear description of the real-world scenario ### Step-by-Step Solution Detailed walkthrough showing: - Tool calls with actual JSON - Expected responses - Explanation of what each tool contributes ### Key Takeaways - What makes the cognitive approach better - Lessons for similar problems - Tips for adaptation ### Try It Yourself - Variations to experiment with - Related scenarios to explore - Next steps for learning ## Running Examples ### Prerequisites ```bash # Ensure ThoughtMCP is installed and running npm install npm run build npm run dev ``` ### Using Examples Most examples show JSON tool calls. You can test these using: **Option 1: Direct MCP Protocol** ```bash # Use your MCP client to send the JSON requests ``` **Option 2: Example Scripts** ```bash # Run provided example scripts npm run example:customer-support npm run example:finance-advisor ``` **Option 3: Interactive Mode** ```bash # Start interactive mode for experimentation npm run interactive ``` ## Example Categories Explained ### Basic Examples - **Purpose**: Learn individual tools - **Complexity**: Simple, focused scenarios - **Time**: 5-10 minutes each - **Prerequisites**: Basic understanding of JSON ### Real-World Scenarios - **Purpose**: See complete problem-solving workflows - **Complexity**: Multi-step, realistic problems - **Time**: 15-30 minutes each - **Prerequisites**: Understanding of basic concepts ### Integration Examples - **Purpose**: Learn implementation patterns - **Complexity**: Code-focused, technical - **Time**: 30-60 minutes each - **Prerequisites**: Programming experience ## Tips for Learning ### Start Simple Begin with basic examples before tackling complex scenarios. ### Experiment Modify the examples to see how changes affect outcomes. ### Compare Approaches Try the same problem with different thinking modes. ### Build Gradually Use simple examples as building blocks for complex applications. ### Focus on Patterns Look for reusable patterns you can apply to your problems. ## Common Questions **Q: Can I modify these examples?** A: Yes! All examples are designed to be adapted and extended. **Q: Do I need to understand cognitive science?** A: No. Examples explain concepts in practical terms. **Q: How do I know which thinking mode to use?** A: Start with "balanced" mode, then experiment with others based on your needs. **Q: Can I combine multiple examples?** A: Absolutely. Many real-world applications combine patterns from multiple examples. **Q: What if an example doesn't work for my use case?** A: Check the integration examples for different implementation approaches, or ask in our discussions. ## Contributing Examples We welcome community examples! See our [contribution guide](../development/contributing.md) for: - Example format guidelines - How to submit new examples - Review process - Recognition for contributors --- _Ready to start? Try [Simple Question Answering](basic/simple-qa.md) for your first example._