Claude_MCP_Server
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:
- 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 endpointGET /
: Server info and available endpointsPOST /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