┌─────────────────────────────────────────────────────────┐
│                    MCP Client (AI Agent)                 │
│         Claude Code / Qwen Code / Claude Desktop        │
└───────────────────────┬─────────────────────────────────┘
                        │ stdio (JSON-RPC)
┌───────────────────────▼─────────────────────────────────┐
│                    MCP Server (this)                     │
│                                                         │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────┐ │
│  │read_file │ │query_    │ │summarize_│ │calculator │ │
│  │list_dir  │ │mysql     │ │url       │ │get_datetime│ │
│  │          │ │(SELECT   │ │          │ │sysinfo    │ │
│  │          │ │ only)    │ │          │ │word_count │ │
│  └──────────┘ └──────────┘ └──────────┘ └───────────┘ │
└─────────────────────────────────────────────────────────┘

# 1. Clone and set up
git clone https://github.com/zyay/mcp-agent-tools.git
cd mcp-agent-tools
python -m venv venv && venv\Scripts\activate    # Windows
# source venv/bin/activate                      # macOS/Linux

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

# 3. Set up MySQL (optional — for query_mysql tool)
mysql -u root -p < setup.sql

# 4. Test the server
python client_test.py

qwen mcp add agent-tools -- python /full/path/to/server.py

{
  "mcpServers": {
    "agent-tools": {
      "command": "python",
      "args": ["/full/path/to/mcp-agent-tools/server.py"]
    }
  }
}

claude mcp add agent-tools -- python /full/path/to/server.py

{
  "mcpServers": {
    "agent-tools": {
      "command": "python",
      "args": ["/full/path/to/mcp-agent-tools/server.py"]
    }
  }
}

User: "What's in the config file at ./settings.json?"
Agent: [calls read_file("./settings.json")]

User: "Show me all clients with projects over $1000"
Agent: [calls query_mysql("SELECT * FROM clients WHERE price > 1000")]

User: "What does the Python docs say about async generators?"
Agent: [calls summarize_url("https://docs.python.org/3/reference/expressions.html")]

User: "If I have 150 items at $12.99 each with 15% discount, what's the total?"
Agent: [calls calculator("150 * 12.99 * 0.85")]

User: "What Python version am I running and what OS?"
Agent: [calls sysinfo()]

# Load demo data
mysql -u root -p < setup.sql

# Verify
mysql -u root -p -e "SELECT * FROM demo.clients;"

set MYSQL_HOST=localhost
set MYSQL_USER=myuser
set MYSQL_PASS=mypassword
python server.py

# Run the test client — lists all tools and calls each one
python client_test.py

# Expected output:
# 🔧 Tools (8): ['read_file', 'list_dir', 'query_mysql', 'summarize_url', ...]
# ✅ query_mysql: [{'id': 1, 'name': 'Firma A', ...}, ...]
# ✅ calculator: 100.0
# ✅ get_datetime: UTC: 2026-08-11 ...
# ...

@mcp.tool()
def my_tool(param: str) -> str:
    """Describe what this tool does — the LLM reads this description.

    Be specific about:
    - What it does
    - What parameters it takes
    - What it returns
    - Any safety considerations
    """
    # Your implementation
    return f"Result for {param}"