Claude MCP Server

A lightweight bridge enabling Claude AI to search the web in real-time. This Flask-based server integrates Claude's advanced capabilities with DuckDuckGo search, allowing the AI to access current information during conversations.

Project Overview

This project implements a server that enables Claude to perform web searches during conversations. It consists of:

MCP Server: A Flask server that handles tool calls and performs web searches
Claude Integration: A client that connects to Claude's API and manages tool use capabilities
Command-line Interface: A simple way to interact with Claude + web search capabilities

Features

🔍 Web Search Integration: Allows Claude to search for information on the web
🤖 Claude 3 API Support: Works with Claude's latest models and tool use features
🌐 DuckDuckGo Search: Uses DuckDuckGo for ethical, tracking-free search results
⚡ Fast Responses: Streamlined architecture for quick information retrieval
💬 Natural Conversation: Claude can seamlessly incorporate web search results into conversations

Setup Instructions

Prerequisites

Python 3.9 or higher
Claude API key

Installation

Clone this repository
Install dependencies:
pip install -r requirements.txt
Set your Claude API key:
# On Windows $env:CLAUDE_API_KEY = "your-api-key" # On Linux/Mac export CLAUDE_API_KEY="your-api-key"

Running the Server

Start the MCP server:
python mcp_server.py
The server will run on port 5001 by default.
Interact with Claude:
python ask_claude.py "your question here"

Architecture

┌─────────────┐     ┌───────────────┐     ┌───────────────┐
│ User Query  │────▶│ Claude Client │────▶│ Claude API    │
└─────────────┘     └───────┬───────┘     └───────┬───────┘
                           │                     │
                           │                     │
                           │                     ▼
                           │             ┌───────────────┐
                           │             │ Tool Call     │
                           │             └───────┬───────┘
                           │                     │
                           ▼                     │
                    ┌───────────────┐            │
                    │ MCP Server    │◀───────────┘
                    └───────┬───────┘
                           │
                           ▼
                    ┌───────────────┐
                    │ Web Search    │
                    └───────────────┘

API Endpoints

GET /health: Health check endpoint
GET /: Server info and available endpoints
POST /tool_call: Process tool calls from Claude

Usage Examples

Ask Claude about current events:

python ask_claude.py "What happened in the world today?"

Ask about technical topics:

python ask_claude.py "Explain the latest advancements in quantum computing"

License

MIT

Acknowledgements

Anthropic for Claude AI
DuckDuckGo for search API

Integrations