# SearXNG MCP Server

A Model Context Protocol (MCP) server that provides web search capabilities using SearXNG.

## Features

- 🔍 Web search using your SearXNG instance
- 🎯 Category filtering (general, news, images, videos, science, etc.)
- 🌍 Multi-language support
- ⏰ Time range filtering
- 🛡️ Safe search options
- 📊 Formatted results with titles, URLs, snippets, and metadata

## Quick Start

### Prerequisites

- Node.js 18 or higher
- A running SearXNG instance
- ngrok (for public sharing)

### Installation

```bash
npm install
```

### Configuration

The server uses the SearXNG instance at `http://192.168.1.44:55001` by default. You can override this with the `SEARXNG_URL` environment variable:

```bash
export SEARXNG_URL=http://your-searxng-instance:port
```

### Running Locally

```bash
npm start
```

### Sharing Publicly with ngrok

1. Install ngrok if you haven't already:
   ```bash
   npm install -g ngrok
   ```

2. Start the MCP server:
   ```bash
   npm start
   ```

3. In another terminal, expose it via ngrok:
   ```bash
   ngrok http 3000
   ```

4. Use the ngrok URL in your MCP client configuration

## Usage in LM Studio

### For Local Use

Add this to your LM Studio MCP settings:

```json
{
  "mcpServers": {
    "searxng": {
      "command": "node",
      "args": ["C:\\Users\\claym\\Desktop\\public mcp\\index.js"],
      "env": {
        "SEARXNG_URL": "http://192.168.1.44:55001"
      }
    }
  }
}
```

### For Public/Shared Use (via ngrok)

When sharing with others, they can use this configuration:

```json
{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "searxng-mcp-server@latest"]
    }
  }
}
```

**Note:** For the npx version to work, you'll need to publish this to npm first.

## Available Tools

### `web_search`

Search the web using SearXNG.

**Parameters:**
- `query` (required): The search query
- `categories` (optional): Search categories - "general", "news", "images", "videos", "science", etc. Default: "general"
- `language` (optional): Language code like "en", "es", "fr". Default: "en"
- `time_range` (optional): Filter by time - "day", "week", "month", "year". Default: all time
- `safesearch` (optional): Safe search level - 0 (off), 1 (moderate), 2 (strict). Default: 0

**Example:**
```
Search for "latest AI news" in the news category from the past week
```

## Development

### Project Structure

```
.
├── index.js          # Main MCP server implementation
├── package.json      # Dependencies and scripts
└── README.md         # This file
```

### Testing

You can test the server using any MCP-compatible client like:
- LM Studio
- Claude Desktop
- Other MCP clients

## Troubleshooting

### Connection Issues

If you can't connect to SearXNG:
1. Verify your SearXNG instance is running: `curl http://192.168.1.44:55001`
2. Check firewall settings
3. Ensure the URL is correct in the configuration

### No Results

If searches return no results:
1. Test the same query directly in SearXNG web interface
2. Try different categories or remove filters
3. Check SearXNG logs for errors

## License

MIT