# 1. Set up environment (one-time setup)
./setup.sh

# 2. Start the server
source .venv311/bin/activate
cd src/mcp_server && python mcp_server.py

# 3. Test with example client
python example_client.py

MCPClientServer/
├── 📁 src/mcp_server/           # Core server implementation
│   ├── mcp_server.py           # Main MCP Wikipedia server
│   └── mcp_client.py           # Example MCP client
├── 📁 tests/                   # Comprehensive test suite
│   ├── test_server.py          # Unit tests (pytest)
│   ├── test_integration.py     # Integration tests
│   ├── test_performance.py     # Performance benchmarks
│   ├── test_mcp_compliance.py  # MCP protocol compliance
│   ├── quick_test.py           # Fast validation script
│   ├── run_tests.py            # Unified test runner
│   └── README.md               # Testing documentation
├── 📁 .venv311/               # Python 3.11 virtual environment
├── 🔧 setup.sh                # Automated setup script
├── 💡 example_client.py        # Usage examples and demos
├── 📖 GUIDE.md                # Complete documentation
├── ⚡ QUICK_REF.md             # Quick reference
├── 📄 pytest.ini              # Test configuration
├── 📄 requirements-test.txt    # Test dependencies
└── 📄 pyproject.toml          # Project configuration

chmod +x setup.sh
./setup.sh

# Set up Python 3.11 environment
pyenv install 3.11.10
pyenv local 3.11.10

# Create and activate virtual environment
python -m venv .venv311
source .venv311/bin/activate

# Install dependencies
pip install --upgrade pip
pip install wikipedia mcp fastmcp

{
  "mcpServers": {
    "wikipedia": {
      "command": "python",
      "args": ["/path/to/MCPClientServer/src/mcp_server/mcp_server.py"],
      "env": {
        "PYTHONPATH": "/path/to/MCPClientServer/.venv311/lib/python3.11/site-packages"
      }
    }
  }
}

from mcp_client import WikipediaClient

client = WikipediaClient()
result = await client.search_wikipedia("Artificial Intelligence")
print(result)

# Fast validation (10 seconds)
python tests/quick_test.py

# Comprehensive test suite (5 minutes)
python tests/run_tests.py

# Install test dependencies
pip install -r requirements-test.txt

# Run specific test suites
python tests/run_tests.py --unit          # Unit tests only
python tests/run_tests.py --integration   # Integration tests only
python tests/run_tests.py --performance   # Performance benchmarks
python tests/run_tests.py --mcp          # MCP compliance tests

# Using pytest directly
python -m pytest tests/test_server.py -v --cov=src