deep-search-mcp

# Deep Search MCP Server A deep web search MCP server using LinkUp API. This is a TypeScript-based MCP server that implements deep web search capabilities. It demonstrates core MCP concepts by providing: - Tools for performing deep web searches - Structured results from LinkUp API ## Features ### Tools - `deep_search` - Perform deep web searches - Takes query string as required parameter - Optional max_results parameter (default: 5) - Returns structured search results ## Setup 1. Install dependencies: ```bash npm install ``` 2. Build the server: ```bash npm run build ``` 3. Configure the MCP server in your settings: ```json { "mcpServers": { "deep-search-mcp": { "command": "node", "args": ["/home/joao/Cline/MCP/linkup-mcp-server/build/index.js"], "env": { "LINKUP_API_KEY": "your-api-key-here" } } } } ``` The API key can be obtained from LinkUp API service. ## Running For development with auto-rebuild: ```bash npm run watch ``` For production: ```bash npm start ``` ## Debugging Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector): ```bash npm run inspector ``` ## NEXT STEPS Future improvements to consider: 1. Add caching for search results to improve performance 2. Implement pagination for large result sets 3. Add filtering options for search results 4. Support different output formats (markdown, HTML) 5. Add rate limiting and request throttling 6. Implement authentication for API access 7. Add more search parameters (date ranges, domains, etc.) 8. Improve error handling and user feedback 9. Add logging for debugging and monitoring 10. Implement health check endpoints