MCP Agent

# MCP Agent A production-ready research agent using the Model Context Protocol (MCP), FastAPI, and Serper web search. ## Features - Async MCP server with web search tool (Serper API) - FastAPI client for HTTP access - Full test suite with pytest and Serper API mocking ## Setup 1. **Clone the repo** 2. **Install dependencies:** ```bash pip install -r requirements.txt ``` 3. **Set your Serper API key:** - Create a `.env` file: ``` SERPER_API_KEY=your_real_serper_api_key REQUEST_TIMEOUT=30 MAX_RESULTS=20 LOG_LEVEL=INFO ``` ## Usage - **Start FastAPI client (runs MCP server as subprocess):** ```bash python -m client.fastapi_client ``` - **POST /search** for web search: ```json { "query": "search term", "max_results": 10 } ``` - **GET /health** for health check ## Testing - **Run all tests:** ```bash pytest tests/test_e2e.py -v ``` - **Run integration test (real Serper API):** ```bash pytest -m integration tests/test_e2e.py ``` --- MIT License