Claude MCP Server

🚀 Claude MCP Server

A lightweight bridge enabling Claude AI to conduct real-time web searches. This Flask-based server integrates Claude's advanced capabilities with DuckDuckGo search, allowing the AI to access current information during conversations.

🚀 Quick Start

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 usage.
3. Command-line Interface: A simple way to interact with Claude with web search capabilities.

✨ Features

• 🔍 Web Search Integration: Allows Claude to search for real-time information.
• 🤖 Claude 3 API Support: Supports the latest models and tool usage features.
• 🌐 DuckDuckGo Search: Uses DuckDuckGo for ethical, tracker-free search results.
• ⚡ Fast Response: A streamlined architecture for quick information retrieval.
• 💬 Natural Conversation: Claude can seamlessly integrate search results into conversations.

📦 Installation

Prerequisites

• Python 3.9 or higher.
• Claude API key.

Installation Steps

1. Clone this repository.
2. Install the 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"
   

🔧 Technical Details

graph TD
    A[User Query] --> B[Claude Client]
    B --> C[Claude API]
    B --> D[Tool Call]
    D --> E[MCP Server]
    E --> F[Web Search]

📚 Documentation

API Endpoints

• GET /health: Health check endpoint.
• GET /: Server information and available endpoints.
• POST /tool_call: Handles Claude's tool calls.

💻 Usage Examples

Basic Usage

Ask about current events:

python ask_claude.py "What major events happened today?"

Ask about technical topics:

python ask_claude.py "Explain the latest progress in quantum computing."

📄 License

This project is licensed under the MIT license.

Acknowledgments

• Anthropic for providing Claude AI.
• DuckDuckGo for providing the search API.