Claude MCP Server

by risherb

Integrations

  • Uses DuckDuckGo's search API to provide ethical, tracking-free web search results that Claude can incorporate into responses

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

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A lightweight Flask-based server that enables Claude AI to perform real-time web searches via DuckDuckGo during conversations, allowing the AI to access current information.

  1. Project Overview
    1. Features
      1. Setup Instructions
        1. Prerequisites
        2. Installation
        3. Running the Server
      2. Architecture
        1. API Endpoints
          1. Usage Examples
            1. License
              1. Acknowledgements

                Related MCP Servers

                • -
                  security
                  A
                  license
                  -
                  quality
                  This MCP server utilizes DuckDuckGo for web searches, providing structured search results with metadata and features like smart content classification and language detection, facilitating easy integration with AI clients supporting the MCP protocol.
                  Last updated -
                  1
                  25
                  1
                  JavaScript
                  MIT License
                • A
                  security
                  A
                  license
                  A
                  quality
                  An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
                  Last updated -
                  1
                  51
                  Python
                  MIT License
                  • Apple
                  • Linux
                • -
                  security
                  F
                  license
                  -
                  quality
                  A server that provides DuckDuckGo search capabilities (text, image, news, video search and AI chat) through the Model Context Protocol.
                  Last updated -
                  Python
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  A server that enables AI assistants like Claude to safely run Python code and access websites, processing data for better AI understanding while providing helpful error messages.
                  Last updated -
                  2
                  Python
                  GPL 3.0
                  • Linux
                  • Apple

                View all related MCP servers

                ID: ojgpb1xe7y