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»).
mcp-flight-searchclaude mcp add flight-search -e 'SERP_API_KEY=<your serp_api_key>' -- uvx mcp-flight-search==0.3.0
{
"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.
المحتويات
MCP Flight Search
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
| Tool | What it does |
|---|---|
search_flights_tool | Flights 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_status | Checks 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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.