Flight Search

السجل الرسمي أدوات المطورين

Search Google Flights through SerpApi: one-way and round-trip flights by IATA airport code.

التثبيت

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

PYPI package mcp-flight-search
Claude Code
claude mcp add flight-search -e 'SERP_API_KEY=<your serp_api_key>' -- uvx mcp-flight-search==0.3.0
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "flight-search": {
            "command": "uvx",
            "args": [
                "mcp-flight-search==0.3.0"
            ],
            "env": {
                "SERP_API_KEY": "<your serp_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • SERP_API_KEY إلزامي سري Your SerpApi key (serpapi.com)

التوثيق

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

المحتويات
  1. MCP Flight Search
  2. Requirements
  3. Use it from an MCP client
  4. Run it yourself
  5. Tools
  6. Development
  7. License

An MCP server that searches Google Flights through SerpApi, for Claude, Cursor and other MCP clients. One-way and round-trip searches by IATA airport code, with prices, durations, stops and times.

Requirements

  • Python 3.10 or later (or uv)
  • A SerpApi key in SERP_API_KEY (serpapi.com has a free tier)

Use it from an MCP client

Add it to your client's MCP configuration (Claude Desktop, Claude Code, Cursor, ...):

{
  "mcpServers": {
    "flight-search": {
      "command": "uvx",
      "args": ["mcp-flight-search"],
      "env": { "SERP_API_KEY": "your-serpapi-key" }
    }
  }
}

Or install it with pip install mcp-flight-search and use "command": "mcp-flight-search".

Run it yourself

export SERP_API_KEY="your-serpapi-key"
mcp-flight-search                                    # stdio (default)
mcp-flight-search --connection_type http --port 3001 # Streamable HTTP at http://127.0.0.1:3001/mcp

LOG_LEVEL=DEBUG shows more detail on stderr. The API key is never logged.

With Docker:

docker build -t mcp-flight-search .
docker run -i --rm -e SERP_API_KEY=your-serpapi-key mcp-flight-search

Tools

ToolWhat it does
search_flights_toolFlights between two airports. origin, destination: IATA codes such as ATL, LAX. outbound_date: YYYY-MM-DD. return_date (optional): YYYY-MM-DD for a round trip. Returns structured results: airline, price (USD), duration, stops, departure, arrival, cabin class.
server_statusChecks the server is running and reports its version.

Development

uv sync
uv run pytest
uv run ruff check .

License

MIT

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

ما هو Flight Search؟

Search Google Flights through SerpApi: one-way and round-trip flights by IATA airport code.

كيف أثبّت Flight Search؟

يعمل على جهازك. في Claude Code: claude mcp add flight-search -e 'SERP_API_KEY=<your serp_api_key>' -- uvx mcp-flight-search==0.3.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Flight Search إلى مفتاح API؟

نعم. يتطلب SERP_API_KEY، وتضبطها في إعداداته.

هل Flight Search مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Flight Search؟

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

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