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
- Clone the repo
- Install dependencies:
pip install -r requirements.txt - Set your Serper API key:
- Create a
.envfile:SERPER_API_KEY=your_real_serper_api_key REQUEST_TIMEOUT=30 MAX_RESULTS=20 LOG_LEVEL=INFO
- Create a
Usage
- Start FastAPI client (runs MCP server as subprocess):
python -m client.fastapi_client - POST /search for web search:
{ "query": "search term", "max_results": 10 } - GET /health for health check
Testing
- Run all tests:
pytest tests/test_e2e.py -v - Run integration test (real Serper API):
pytest -m integration tests/test_e2e.py
MIT License