English Français العربية

io.github.gustavoatar/instafan

السجل الرسمي البحث والويب

Plan trips with friends: mood search, live briefs, top spots with photos, day-by-day itineraries.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http instafan 'https://instafan.app/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "instafan": {
            "type": "http",
            "url": "https://instafan.app/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Instafan MCP Server
  2. Tools
  3. Connect
  4. Example
  5. About
  6. License

Instafan MCP Server

Let AI agents plan real trips — where to go for a mood, what a destination is like right now, its strongest Google-rated places with photos, and a day-by-day plan — using Instafan's live data (Google Places, climate normals, official safety advisories).

Hosted, no install, no auth. Streamable-HTTP endpoint:

https://instafan.app/mcp

Tools

ToolWhat it doesInputs
find_destinationsA trip mood or constraint set ("somewhere warm in November, food-first") → 3–5 destination suggestions with the why.mood (required)
destination_briefOne destination: the story, typical weather this month, official safety verdict, a postcard photo link.destination (required)
top_spotsThe strongest real Google-rated places — top attractions by default, or a specific ask like "rooftop bars" — with photo links. Never invented.destination (required), query
build_itineraryA day-by-day plan built from the destination's strongest places.destination, days (both required)
spot_photosUp to two real photos of one spot, embedded inline as MCP image blocks plus direct links, credited to their Google Maps authors.destination (required), spot

Connect

ChatGPT → Settings → Apps & Connectors → enable Developer mode → Create → URL: https://instafan.app/mcp, auth: none.

Claude Desktop / Claude.ai → Settings → Connectors → Add custom connector → URL: https://instafan.app/mcp

Claude Code:

claude mcp add instafan --transport http https://instafan.app/mcp

Cursor / other MCP clients — add a remote (streamable-http) server pointing at the URL above. One-click: see https://instafan.app/connect/

Test with curl:

curl -s -X POST https://instafan.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Example

"Build me a Lisbon trip for my wife and I in the best weather."

The agent calls destination_brief → learns Lisbon is 18–26°C with ~4 rainy days right now and officially rated relaxed; top_spots → real rated places with photos; spot_photos → Belém Tower, inline; build_itinerary → a day-by-day plan. Every answer links back into instafan.app, where the trip becomes a group decision — immerse in 3D, save spots, let the group vote.

About

Built by Instafan — plan trips with friends. https://instafan.app

License

MIT

الأسئلة الشائعة

ما هو io.github.gustavoatar/instafan؟

Plan trips with friends: mood search, live briefs, top spots with photos, day-by-day itineraries.

كيف أثبّت io.github.gustavoatar/instafan؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http instafan 'https://instafan.app/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.gustavoatar/instafan إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.gustavoatar/instafan مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.gustavoatar/instafan؟

ينشره gustavoatar. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.