ollama-websearch-mcp

# Ollama Web Search MCP Service A MCP (Model Context Protocol) service for performing web searches using Ollama. ## Features - Perform web searches using Ollama's search capabilities - Format search results for easy consumption - Official MCP Python SDK implementation - Environment-based configuration - Comprehensive error handling - Stdio-based communication interface ## Installation & Usage ### Option 1: Direct execution with uvx (Recommended) Install and run directly using uvx: ```bash uvx ollama-websearch-mcp ``` This will automatically install the package and its dependencies, then start the MCP server. ### Option 2: Local development For local development, clone the repository and install dependencies: ```bash git clone https://github.com/huangxinping/ollama-websearch-mcp.git cd ollama-websearch-mcp uv sync ``` ### Local usage commands **Run as MCP Server (for development)**: ```bash python mcp_service.py ``` **Build Package**: ```bash uv build ``` ## MCP Interface ### Tools 1. **search** - Description: Perform a web search using Ollama - Parameters: - `query` (string): The search query - `max_results` (integer, optional): Maximum number of results to return (default: 3, range: 1-10) ### Example Output Search result format: ``` 1. Example Title URL: https://example.com Content: Example content from the search result... 2. Another Title URL: https://another-example.com Content: Another example content... ``` ## Project Structure ``` ollama-websearch-mcp/ ├── mcp_service.py # MCP service main program ├── README.md # Project documentation ├── .env # Environment variables ├── .gitignore # Git ignore file ├── pyproject.toml # Project configuration file ├── setup.py # Package setup file └── uv.lock # Dependency lock file ``` ## Tech Stack - **Python 3.12+**: Programming language - **MCP**: Model Cont…