mcp-template-typescript

This project is a server that provides the Naver News Search API as a Model Context Protocol (MCP) interface. ## Features ### News Search * Provides keyword-based news search functionality for the Naver News Search API * Supports various sorting options (by relevance, by date) * Supports pagination (up to 1000 results) * Adjusts the number of results displayed at once (up to 100) ## Installation ### Installation via npm ```bash npm install -g naver-news-mcp-server ``` ### Installation from source code ```bash # Clone the repository git clone https://github.com/your-username/naver-news-mcp.git cd naver-news-mcp # Install dependencies and build npm install npm run build ``` ## Development Environment Setup ### Setting Environment Variables Create a `.env` file and add the following content: ```bash # Copy the .env.example file to create a .env file cp .env.example .env # Open the .env file and modify the following content NAVER_CLIENT_ID=your_naver_client_id_here NAVER_CLIENT_SECRET=your_naver_client_secret_here ``` ### Running the Development Server ```bash # Run in development mode npm run dev # Build npm run build # Start npm start ``` ## API Usage ### News Search Parameters ```typescript { query: string; // The query term you want to search (UTF-8 encoding required) display?: number; // The number of search results to display at once (default: 10, max: 100) start?: number; // The starting position for the search (default: 1, max: 1000) sort?: 'sim' | 'date'; // Sorting options (sim: by relevance, date: by date) } ``` ## MCP Server Setup ### Running the MCP Server ```bash npx -y naver-news-mcp-server ``` ### Example MCP Configuration ```json { "naver-news-search": { "command": "npx", "args": [ "-y", "naver-news-mcp" ], "env": { "NAVER_CLIENT_ID": "your_naver_client_id_here", "NAVER_CLIENT_SECRET": "your_naver_client_secret_here" } } } ``` ## System Requirements * Node.js >= 18.0.0 ## License MIT