Naver Flight

Provides live flight search results from Naver with lowest fares, flight details, and SSE streaming for complete data collection.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "insikhwang-naver-flight-mcp": {
      "command": "node",
      "args": [
        "C:/Users/{사용자명}/naver-flight-mcp/dist/index.js"
      ]
    }
  }
}

You deploy this MCP server to query real-time flight data from Naver’s flight search API. It focuses on returning the lowest fares for direct, economy-class adult travel and provides top results with accompanying flight details, all while streaming data for better completeness and traceable logs.

How to use

After you start the MCP server, you can connect with a compatible MCP client to perform flight searches. Use a concise search prompt to request the lowest fares for a specific route and date range. The server supports queries for direct flights, economy class, and a single adult passenger, returning the top fare results along with outbound and return flight details and timings.

How to install

Prerequisites: you need Node.js installed on your system. Ensure you have access to a terminal or command prompt.

Clone the project, install dependencies, and build the TypeScript sources.

git clone https://github.com/your-username/naver-flight-mcp.git
cd naver-flight-mcp

npm install

npm run build

Configuration for MCP client (Cursor)

Set up the Cursor MCP configuration to run the local MCP server. The example shows a Windows path for the built index file. Create or edit your Cursor MCP settings file and point to the compiled entry point.

{
  "mcpServers": {
    "naver-flight": {
      "command": "node",
      "args": ["C:/Users/{사용자명}/naver-flight-mcp/dist/index.js"],
      "env": {}
    }
  }
}

Checkpoint for running

After adding the MCP configuration, restart Cursor. The Naver flight search tool becomes available through your MCP client, ready to process queries.

Notes on installation and paths

The setup references are shown as concrete Windows paths or generic placeholders. Replace the placeholder with your actual user name and paths on your system when configuring the MCP entry point.

Usage notes and examples

You can issue flight search requests focusing on direct routes, economy class, and a single adult passenger. The server returns up to the top 10 lowest fares, with flight times and carrier details included in the results.

Troubleshooting

If you do not see results or receive an error, verify that the MCP server process is running, the path to the built index.js is correct, and that your MCP client is pointing to the correct server configuration. Check the logs for any streaming data warnings during SSE handling.

Available tools

NaverFlightSearch

The flight search tool that interfaces with Naver's flight API to retrieve direct, economy-class flight options and associated flight details for given routes and dates.