xzmaxtoy/kidsense-family-mcp-server

KidSense Family Assistant MCP Server

A FastMCP server providing family-focused tools for the KidSense LangGraph agent.

🛠️ Tools Available

🎮 Family Activities

• search_family_activities: Find age-appropriate activities by location and type
• plan_educational_activities: Get educational content and learning activities

🍽️ Family Nutrition

• find_healthy_recipes: Kid-friendly healthy recipes with dietary restrictions
• get_family_meal_planning: Weekly meal planning with shopping lists

👨‍👩‍👧‍👦 Parenting Support

• get_parenting_tips: Age-appropriate parenting advice and strategies

🧪 Testing

• echo_tool: Simple echo tool for testing MCP connections

🚀 Local Development

# Install dependencies
pip install -r requirements.txt

# Run server locally
python server.py

# Server will be available at http://localhost:8000/mcp

📡 Testing the Server

# Test tools list
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

# Test echo tool
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "echo_tool", "arguments": {"text": "Hello from KidSense!"}}}'

🌐 Deployment to fastmcp.cloud

1. Push to GitHub: Commit all files to your repository
2. Connect to fastmcp.cloud: Link your GitHub repo
3. Deploy: fastmcp.cloud will automatically deploy from /fastmcp-server/
4. Get Endpoint: Use the provided URL in your LangGraph agent

🔧 Integration with LangGraph

The deployed MCP server provides an HTTP/JSON API that works perfectly with Edge Functions:

// In your LangGraph Edge Function
const KIDSENSE_MCP_ENDPOINT = 'https://your-deployment.fastmcp.app/mcp'

const response = await fetch(KIDSENSE_MCP_ENDPOINT, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json, text/event-stream'
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
      name: 'search_family_activities',
      arguments: {
        location: 'San Francisco',
        age_range: '5-12',
        activity_type: 'educational'
      }
    }
  })
})

🎯 Family-Focused Features

• Age-Appropriate Content: All tools consider child age and development
• Safety First: Activities and advice prioritize family safety
• Educational Value: Learning opportunities integrated into all recommendations
• Practical Tips: Actionable advice for busy parents
• Dietary Awareness: Healthy, kid-friendly nutrition options
• Budget Conscious: Considers family budget constraints