Claude_MCP_Server

Claude_MCP_Server

3.2

If you are the rightful owner of Claude_MCP_Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A lightweight bridge enabling Claude AI to search the web in real-time using a Flask-based server integrated with DuckDuckGo.

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

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

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ 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