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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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.

Related MCP Servers

Perplexity MCP Server
jsonallen
A
security
A
license
A
quality
A server facilitating web search functionality by utilizing Perplexity AI's API, designed to integrate with the Claude desktop client for enhanced search queries.
Last updated -
1
205
Python
MIT License
MCP Unified Server
getfounded
-
security
A
license
-
quality
A modular server implementation for Claude AI assistants with integrated tools, enabling Claude to perform actions and access external resources like file systems, web searches, browser automation, financial data, and document generation.
Last updated -
86
Python
MIT License
MCP Web Research Server
jevy
-
security
A
license
-
quality
A server that integrates with Claude Desktop to enable real-time web research capabilities, allowing users to search Google, extract webpage content, and capture screenshots directly from conversations.
Last updated -
525
MIT License
Exa MCP Server
geezerrrr
-
security
A
license
-
quality
A server that enables AI assistants like Claude to perform web searches using the Exa AI Search API, providing real-time web information in a safe and controlled way.
Last updated -
6,082
MIT License

View all related MCP servers

Claude MCP Server