@itaykarkason/mcp-vibe

🌈 Daily Vibe Generator - MCP Server

עוזר שנותן לך "וייב יומי" אמיתי — מבוסס על APIs חינמיים

MCP server חמוד וקליל שנותן לך וייב יומי עם ציטוטים, עובדות מעניינות, ועצות מותאמות אישית לפי השעה והיום.

✨ מה זה עושה?

כלי אחד פשוט: get_daily_vibe()

ה-MCP:

• 🎯 מושך ציטוט אקראי מ-API חינמי
• 🐱 מושך עובדה אקראית / חיה חמודה / בדיחה
• ⏰ משלב את זה עם השעה והיום
• 💫 מחזיר "וייב" קצר וחמוד עם עצה מותאמת

🚀 התקנה

# דרישות: Node.js 18+ ו-npm

# התקנת תלויות
npm install

# בניית הפרויקט
npm run build

📦 APIs חינמיים (בלי מפתח!)

השרת משתמש ב-APIs חינמיים לחלוטין:

• Quotable - ציטוטים יפים: https://api.quotable.io/random
• Cat Facts - עובדות על חתולים: https://catfact.ninja/fact
• Numbers API - עובדות מוזרות על מספרים: http://numbersapi.com/random/trivia?json
• Joke API - בדיחות: https://official-joke-api.appspot.com/random_joke

🎯 שימוש

כשרת MCP

הוסף את השרת ל-Cursor/Claude Desktop:

{
  "mcpServers": {
    "daily-vibe": {
      "command": "node",
      "args": ["/path/to/mcp-vibe/dist/server.js"]
    }
  }
}

או עם tsx לפיתוח (ללא build):

{
  "mcpServers": {
    "daily-vibe": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-vibe/server.ts"]
    }
  }
}

כסקריפט עצמאי

# לאחר build
npm start

# או עם tsx (ללא build)
npm run dev

📝 דוגמה לתוצאה

{
  "vibe": "🌅 בוקר - מוטיבציה ופוקוס | יום ראשון - התחלה חדשה",
  "quote": "Simplicity is the ultimate sophistication.",
  "author": "Leonardo da Vinci",
  "fun_fact": "Cats sleep for around 70% of their lives.",
  "suggestion": "תתחיל את היום עם משהו קטן וקל",
  "timestamp": "2024-01-15 09:30:00"
}

🎨 תכונות

⏰ וייבים מותאמים לפי זמן

• 🌅 בוקר מוקדם (5-9) - אנרגיה טרייה
• ☀️ בוקר (9-12) - מוטיבציה ופוקוס
• 🌆 צהריים (12-14) - אנרגיה גבוהה
• 🌆 אחר הצהריים (14-17) - יצירתיות
• 🌆 ערב (17-21) - רוגע וסיכום
• 🌙 לילה (21-5) - מנוחה והתבוננות

📅 התאמה לפי יום בשבוע

• יום ראשון - התחלה חדשה
• יום חמישי - בוסט לפני סוף השבוע
• יום שישי - סוף שבוע מתקרב

🛠️ פיתוח

הקוד כתוב ב-TypeScript/Node.js ומשתמש ב:

• @modelcontextprotocol/sdk - MCP SDK
• axios - HTTP client
• typescript - TypeScript compiler
• tsx - TypeScript execution (לפיתוח)

סקריפטים זמינים

npm run build    # קומפילציה ל-JavaScript
npm start        # הרצת השרת (לאחר build)
npm run dev      # הרצה ישירה עם tsx (ללא build)

📄 רישיון

MIT License - חופשי לשימוש!

🤝 תרומה

תמיד שמחים לתרומות! פתח issue או PR.

נהנה מהוייב היומי שלך! 🌈✨