Skip to main content
Glama
Claude MCP Custom Tools Server

Claude MCP Custom Tools Server

๐Ÿ“ฆ 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

Related MCP server: mcp-web-search

โš™๏ธ 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      A Model Context Protocol server exposing 58 online tools (crypto, data, image, text, etc.) and workflow execution, enabling MCP clients like Claude Desktop to invoke them via natural language.
      58
      8 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides DuckDuckGo web search and site fetching tools for Claude Desktop, enabling up to 10 search results and text content extraction from URLs.
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides a document store, web search, and safe calculator as MCP tools, enabling both offline and LLM-driven clients to discover and call them over the Model Context Protocol.
      6
      MIT