📦 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

python -m venv .venv

Windows

.venv\Scripts\activate

macOS / Linux

source .venv/bin/activate

2️⃣ Install required packages

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.

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

{
  "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