{"_id":"@iflow-mcp/ihor-sokoliuk-mcp-searxng","name":"@iflow-mcp/ihor-sokoliuk-mcp-searxng","dist-tags":{"latest":"0.9.1"},"versions":{"0.9.1":{"name":"@iflow-mcp/ihor-sokoliuk-mcp-searxng","version":"0.9.1","description":"MCP server for SearXNG integration","license":"MIT","author":{"name":"Ihor Sokoliuk","url":"https://github.com/ihor-sokoliuk"},"homepage":"https://github.com/ihor-sokoliuk/mcp-searxng","bugs":{"url":"https://github.com/ihor-sokoliuk/mcp-searxng/issues"},"repository":{"type":"git","url":"git+https://github.com/ihor-sokoliuk/mcp-searxng.git"},"keywords":["mcp","modelcontextprotocol","searxng","search","web-search","claude","ai","pagination","smithery","url-reader"],"type":"module","bin":{"iflow-mcp-ihor-sokoliuk-mcp-searxng":"dist/index.js"},"main":"dist/index.js","engines":{"node":">=20"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","test":"SEARXNG_URL=https://test-searx.example.com tsx __tests__/run-all.ts","test:coverage":"SEARXNG_URL=https://test-searx.example.com c8 --reporter=text tsx __tests__/run-all.ts","bootstrap":"npm install && npm run build","inspector":"DANGEROUSLY_OMIT_AUTH=true npx @modelcontextprotocol/inspector node dist/index.js","postversion":"TAG=$(node scripts/update-version.js | tail -1) && git add src/index.ts && git commit --amend --no-edit && git tag -f $TAG"},"dependencies":{"@modelcontextprotocol/sdk":"1.17.4","@types/cors":"^2.8.19","@types/express":"^5.0.3","cors":"^2.8.5","express":"^5.1.0","node-html-markdown":"^1.3.0","undici":"^6.20.1"},"devDependencies":{"mcp-evals":"^1.0.18","@types/node":"^22.17.2","@types/supertest":"^6.0.3","c8":"^10.1.3","shx":"^0.4.0","supertest":"^7.1.4","tsx":"^4.20.5","typescript":"^5.8.3"},"types":"./dist/index.d.ts","_id":"@iflow-mcp/ihor-sokoliuk-mcp-searxng@0.9.1","_integrity":"sha512-YVZqECRSZ7JMHidgZl58Uz7vjVk5Xo/PJbEj8fWq+ApBKNYPhT4olSq1jxBJCq/8mN2UGbj3qyJissu0u34PqA==","_resolved":"/app/auto-mcp-upload/data/12354/iflow-mcp-ihor-sokoliuk-mcp-searxng-0.9.1.tgz","_from":"file:/app/auto-mcp-upload/data/12354/iflow-mcp-ihor-sokoliuk-mcp-searxng-0.9.1.tgz","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-YVZqECRSZ7JMHidgZl58Uz7vjVk5Xo/PJbEj8fWq+ApBKNYPhT4olSq1jxBJCq/8mN2UGbj3qyJissu0u34PqA==","shasum":"d5360bf091a77bc45a454e8b27d4d34ac4ff95e2","tarball":"https://registry.npmjs.org/@iflow-mcp/ihor-sokoliuk-mcp-searxng/-/ihor-sokoliuk-mcp-searxng-0.9.1.tgz","fileCount":23,"unpackedSize":65636,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCAAX0TE8/drXHBYA+gFZAyYG8D9d0de546DDqPB/PrjwIgAu4pdt4jNF8jUvrFPnYvFaLeocqazG0dEYoqz8W0FVo="}]},"_npmUser":{"name":"chatflowdev","email":"chatflowdev@gmail.com"},"directories":{},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ihor-sokoliuk-mcp-searxng_0.9.1_1772228766064_0.778294293653518"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-27T21:46:05.913Z","0.9.1":"2026-02-27T21:46:06.201Z","modified":"2026-02-27T21:46:06.501Z"},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"description":"MCP server for SearXNG integration","homepage":"https://github.com/ihor-sokoliuk/mcp-searxng","keywords":["mcp","modelcontextprotocol","searxng","search","web-search","claude","ai","pagination","smithery","url-reader"],"repository":{"type":"git","url":"git+https://github.com/ihor-sokoliuk/mcp-searxng.git"},"author":{"name":"Ihor Sokoliuk","url":"https://github.com/ihor-sokoliuk"},"bugs":{"url":"https://github.com/ihor-sokoliuk/mcp-searxng/issues"},"license":"MIT","readme":"# SearXNG MCP Server\n\nAn [MCP server](https://modelcontextprotocol.io/introduction) implementation that integrates the [SearXNG](https://docs.searxng.org) API, providing web search capabilities.\n\n[![https://nodei.co/npm/mcp-searxng.png?downloads=true&downloadRank=true&stars=true](https://nodei.co/npm/mcp-searxng.png?downloads=true&downloadRank=true&stars=true)](https://www.npmjs.com/package/mcp-searxng)\n\n[![https://badgen.net/docker/pulls/isokoliuk/mcp-searxng](https://badgen.net/docker/pulls/isokoliuk/mcp-searxng)](https://hub.docker.com/r/isokoliuk/mcp-searxng)\n\n<a href=\"https://glama.ai/mcp/servers/0j7jjyt7m9\"><img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/0j7jjyt7m9/badge\" alt=\"SearXNG Server MCP server\" /></a>\n\n## Features\n\n- **Web Search**: General queries, news, articles, with pagination.\n- **URL Content Reading**: Advanced content extraction with pagination, section filtering, and heading extraction.\n- **Intelligent Caching**: URL content is cached with TTL (Time-To-Live) to improve performance and reduce redundant requests.\n- **Pagination**: Control which page of results to retrieve.\n- **Time Filtering**: Filter results by time range (day, month, year).\n- **Language Selection**: Filter results by preferred language.\n- **Safe Search**: Control content filtering level for search results.\n\n## Tools\n\n- **searxng_web_search**\n  - Execute web searches with pagination\n  - Inputs:\n    - `query` (string): The search query. This string is passed to external search services.\n    - `pageno` (number, optional): Search page number, starts at 1 (default 1)\n    - `time_range` (string, optional): Filter results by time range - one of: \"day\", \"month\", \"year\" (default: none)\n    - `language` (string, optional): Language code for results (e.g., \"en\", \"fr\", \"de\") or \"all\" (default: \"all\")\n    - `safesearch` (number, optional): Safe search filter level (0: None, 1: Moderate, 2: Strict) (default: instance setting)\n\n- **web_url_read**\n  - Read and convert the content from a URL to markdown with advanced content extraction options\n  - Inputs:\n    - `url` (string): The URL to fetch and process\n    - `startChar` (number, optional): Starting character position for content extraction (default: 0)\n    - `maxLength` (number, optional): Maximum number of characters to return\n    - `section` (string, optional): Extract content under a specific heading (searches for heading text)\n    - `paragraphRange` (string, optional): Return specific paragraph ranges (e.g., '1-5', '3', '10-')\n    - `readHeadings` (boolean, optional): Return only a list of headings instead of full content\n\n## Configuration\n\n### Environment Variables\n\n#### Required\n- **`SEARXNG_URL`**: SearXNG instance URL (default: `http://localhost:8080`)\n  - Format: `<protocol>://<hostname>[:<port>]`\n  - Example: `https://search.example.com`\n\n#### Optional\n- **`AUTH_USERNAME`** / **`AUTH_PASSWORD`**: HTTP Basic Auth credentials for password-protected instances\n- **`USER_AGENT`**: Custom User-Agent header (e.g., `MyBot/1.0`)\n- **`HTTP_PROXY`** / **`HTTPS_PROXY`**: Proxy URLs for routing traffic\n  - Format: `http://[username:password@]proxy.host:port`\n- **`NO_PROXY`**: Comma-separated bypass list (e.g., `localhost,.internal,example.com`)\n\n## Installation & Configuration\n\n### [NPX](https://www.npmjs.com/package/mcp-searxng)\n\n```json\n{\n  \"mcpServers\": {\n    \"searxng\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-searxng\"],\n      \"env\": {\n        \"SEARXNG_URL\": \"YOUR_SEARXNG_INSTANCE_URL\"\n      }\n    }\n  }\n}\n```\n\n<details>\n<summary>Full Configuration Example (All Options)</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"searxng\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-searxng\"],\n      \"env\": {\n        \"SEARXNG_URL\": \"YOUR_SEARXNG_INSTANCE_URL\",\n        \"AUTH_USERNAME\": \"your_username\",\n        \"AUTH_PASSWORD\": \"your_password\",\n        \"USER_AGENT\": \"MyBot/1.0\",\n        \"HTTP_PROXY\": \"http://proxy.company.com:8080\",\n        \"HTTPS_PROXY\": \"http://proxy.company.com:8080\",\n        \"NO_PROXY\": \"localhost,127.0.0.1,.local,.internal\"\n      }\n    }\n  }\n}\n```\n\n**Note:** Mix and match environment variables as needed. All optional variables can be used independently or together.\n\n</details>\n\n### [NPM](https://www.npmjs.com/package/mcp-searxng)\n\n```bash\nnpm install -g mcp-searxng\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"searxng\": {\n      \"command\": \"mcp-searxng\",\n      \"env\": {\n        \"SEARXNG_URL\": \"YOUR_SEARXNG_INSTANCE_URL\"\n      }\n    }\n  }\n}\n```\n\n<details>\n<summary>Full Configuration Example (All Options)</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"searxng\": {\n      \"command\": \"mcp-searxng\",\n      \"env\": {\n        \"SEARXNG_URL\": \"YOUR_SEARXNG_INSTANCE_URL\",\n        \"AUTH_USERNAME\": \"your_username\",\n        \"AUTH_PASSWORD\": \"your_password\",\n        \"USER_AGENT\": \"MyBot/1.0\",\n        \"HTTP_PROXY\": \"http://proxy.company.com:8080\",\n        \"HTTPS_PROXY\": \"http://proxy.company.com:8080\",\n        \"NO_PROXY\": \"localhost,127.0.0.1,.local,.internal\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n### Docker\n\n#### Using [Pre-built Image from Docker Hub](https://hub.docker.com/r/isokoliuk/mcp-searxng)\n\n```bash\ndocker pull isokoliuk/mcp-searxng:latest\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"searxng\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \"SEARXNG_URL\",\n        \"isokoliuk/mcp-searxng:latest\"\n      ],\n      \"env\": {\n        \"SEARXNG_URL\": \"YOUR_SEARXNG_INSTANCE_URL\"\n      }\n    }\n  }\n}\n```\n\n<details>\n<summary>Full Configuration Example (All Options)</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"searxng\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \"SEARXNG_URL\",\n        \"-e\", \"AUTH_USERNAME\",\n        \"-e\", \"AUTH_PASSWORD\",\n        \"-e\", \"USER_AGENT\",\n        \"-e\", \"HTTP_PROXY\",\n        \"-e\", \"HTTPS_PROXY\",\n        \"-e\", \"NO_PROXY\",\n        \"isokoliuk/mcp-searxng:latest\"\n      ],\n      \"env\": {\n        \"SEARXNG_URL\": \"YOUR_SEARXNG_INSTANCE_URL\",\n        \"AUTH_USERNAME\": \"your_username\",\n        \"AUTH_PASSWORD\": \"your_password\",\n        \"USER_AGENT\": \"MyBot/1.0\",\n        \"HTTP_PROXY\": \"http://proxy.company.com:8080\",\n        \"HTTPS_PROXY\": \"http://proxy.company.com:8080\",\n        \"NO_PROXY\": \"localhost,127.0.0.1,.local,.internal\"\n      }\n    }\n  }\n}\n```\n\n**Note:** Add only the `-e` flags and env variables you need.\n\n</details>\n\n#### Build Locally\n\n```bash\ndocker build -t mcp-searxng:latest -f Dockerfile .\n```\n\nUse the same configuration as above, replacing `isokoliuk/mcp-searxng:latest` with `mcp-searxng:latest`.\n\n#### Docker Compose\n\nCreate a `docker-compose.yml` file:\n\n```yaml\nservices:\n  mcp-searxng:\n    image: isokoliuk/mcp-searxng:latest\n    stdin_open: true\n    environment:\n      - SEARXNG_URL=YOUR_SEARXNG_INSTANCE_URL\n      # Add any optional variables as needed:\n      # - AUTH_USERNAME=your_username\n      # - AUTH_PASSWORD=your_password\n      # - USER_AGENT=MyBot/1.0\n      # - HTTP_PROXY=http://proxy.company.com:8080\n      # - HTTPS_PROXY=http://proxy.company.com:8080\n      # - NO_PROXY=localhost,127.0.0.1,.local,.internal\n```\n\nThen configure your MCP client:\n\n```json\n{\n  \"mcpServers\": {\n    \"searxng\": {\n      \"command\": \"docker-compose\",\n      \"args\": [\"run\", \"--rm\", \"mcp-searxng\"]\n    }\n  }\n}\n```\n\n### HTTP Transport (Optional)\n\nThe server supports both STDIO (default) and HTTP transports. Set `MCP_HTTP_PORT` to enable HTTP mode.\n\n```json\n{\n  \"mcpServers\": {\n    \"searxng-http\": {\n      \"command\": \"mcp-searxng\",\n      \"env\": {\n        \"SEARXNG_URL\": \"YOUR_SEARXNG_INSTANCE_URL\",\n        \"MCP_HTTP_PORT\": \"3000\"\n      }\n    }\n  }\n}\n```\n\n**HTTP Endpoints:**\n- **MCP Protocol**: `POST/GET/DELETE /mcp` \n- **Health Check**: `GET /health`\n\n**Testing:**\n```bash\nMCP_HTTP_PORT=3000 SEARXNG_URL=http://localhost:8080 mcp-searxng\ncurl http://localhost:3000/health\n```\n\n## Running evals\n\n```bash\nSEARXNG_URL=YOUR_URL OPENAI_API_KEY=your-key npx mcp-eval evals.ts src/index.ts\n```\n\n## For Developers\n\n### Contributing\n\nWe welcome contributions! Follow these guidelines:\n\n**Coding Standards:**\n- Use TypeScript with strict type safety\n- Follow existing error handling patterns\n- Write concise, informative error messages\n- Include unit tests for new functionality\n- Maintain 90%+ test coverage\n- Test with MCP inspector before submitting\n- Run evals to verify functionality\n\n**Workflow:**\n\n1. **Fork and clone:**\n   ```bash\n   git clone https://github.com/YOUR_USERNAME/mcp-searxng.git\n   cd mcp-searxng\n   git remote add upstream https://github.com/ihor-sokoliuk/mcp-searxng.git\n   ```\n\n2. **Setup:**\n   ```bash\n   npm install\n   npm run watch  # Development mode with file watching\n   ```\n\n3. **Development:**\n   ```bash\n   git checkout -b feature/your-feature-name\n   # Make changes in src/\n   npm run build\n   npm test\n   npm run test:coverage\n   npm run inspector\n   ```\n\n4. **Submit:**\n   ```bash\n   git commit -m \"feat: description\"\n   git push origin feature/your-feature-name\n   # Create PR on GitHub\n   ```\n\n### Testing\n\n```bash\nnpm test                    # Run all tests\nnpm run test:coverage      # Generate coverage report\nnpm run test:watch         # Watch mode\n```\n\n**Coverage:** 100% success rate with comprehensive unit tests covering error handling, types, proxy configs, resources, and logging.\n\n## License\n\nThis MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.\n","readmeFilename":"README.md","_rev":"1-dd62f348d398e166002e9a1b5941642f"}