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:

1. MCP Server: A Flask server that handles tool calls and performs web searches

2. Claude Integration: A client that connects to Claude's API and manages tool use capabilities

3. Command-line Interface: A simple way to interact with Claude + web search capabilities

Related MCP server: Perplexity MCP Server

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

1. Clone this repository

2. Install dependencies:

   pip install -r requirements.txt

3. 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

1. Start the MCP server:

   python mcp_server.py

   The server will run on port 5001 by default.

2. Interact with Claude:

   python ask_claude.py "your question here"

Architecture

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:

Ask about technical topics:

License

MIT

Acknowledgements

• Anthropic for Claude AI

• DuckDuckGo for search API