# 📦 Claude MCP Custom Tools Server (Python)

This project implements a **Model Context Protocol (MCP) server** in **Python** that connects to **Claude Desktop** and exposes multiple custom tools such as:

* 🏠 Airbnb (simulated search)
* 🔍 DuckDuckGo web search
* 📚 Wikipedia search
* 📄 ArXiv research papers
* ➕➗ Custom math tools (add, multiply)

Claude can automatically invoke these tools via MCP using **stdio** communication.

---
## 📁 Project Structure

```
mcp_server_Claude/
│
├── .venv/                     # Python virtual environment
│
├── tools/                     # All MCP tools
│   ├── __init__.py
│   ├── airbnb.py              # Simulated Airbnb tool
│   ├── arxiv.py               # ArXiv research tool
│   ├── ddg.py                 # DuckDuckGo search
│   ├── maths.py               # Add & Multiply tools
│   └── wiki.py                # Wikipedia search
│
├── server.py                  # Main MCP server entry point
├── requirements.txt           # Python dependencies
└── README.md
```

---

## ⚙️ Requirements

* Python **3.10+**
* Claude Desktop (latest)
* Windows / macOS / Linux

---

## 📦 Install Dependencies

### 1️⃣ Create & activate virtual environment

```bash
python -m venv .venv
```

**Windows**

```bash
.venv\Scripts\activate
```

**macOS / Linux**

```bash
source .venv/bin/activate
```

---

### 2️⃣ Install required packages

```bash
pip install -r requirements.txt
```

---

## 🛠️ Tools Included

### ➕➗ Math Tools

* `add(a, b)`
* `multiply(a, b)`

### 🔍 DuckDuckGo

* Web search without API key

### 📚 Wikipedia

* Short factual summaries

### 📄 ArXiv

* Academic research paper search

### 🏠 Airbnb

* Simulated listing search (demo purpose)

---

## 🚀 How to Run MCP Server (Local Test)

Before connecting Claude, **always test locally**.

```bash
cd D:/mcp_server_Claude
python server.py
```

### ✅ Expected behavior

* No errors
* Process stays running
* Press `CTRL + C` to stop

If it crashes, Claude will also fail to connect.

---

## 🔌 Claude Desktop MCP Configuration

### 📍 Config file location (Windows)

```
%APPDATA%\Claude\claude_desktop_config.json
```

---

### ✅ MCP Server Configuration

```json
{
  "mcpServers": {
    "custom-tools": {
      "command": "D:/mcp_server_Claude/.venv/Scripts/python.exe",
      "args": ["D:/mcp_server_Claude/server.py"]
    }
  }
}
```

---

### 🔁 Restart Claude Desktop

Fully close and reopen Claude after editing the config.

---

## 🧪 Testing in Claude

Try any of the following prompts:

```
Add 15 and 25
```

```
Multiply 6 and 7
```

```
Search DuckDuckGo for latest AI agent frameworks
```

```
Find arxiv papers on LLM agents
```

```
Search Airbnb in Bangalore for 2 guests
```

Claude will automatically call the appropriate tool.

---
Author: Husen Basha
---