Claude MCP Server

Claude MCP Server

By risherb GitHub

-

Overview

what is Claude MCP Server?

Claude MCP Server is a lightweight bridge that enables Claude AI to perform real-time web searches during conversations, integrating its capabilities with DuckDuckGo search for current information access.

how to use Claude MCP Server?

To use the server, clone the repository, install the dependencies, set your Claude API key, and run the server. You can then interact with Claude using command-line queries.

key features of Claude MCP Server?

  • 🔍 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: Utilizes 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.

use cases of Claude MCP Server?

  1. Asking Claude about current events.
  2. Inquiring about technical topics like advancements in quantum computing.
  3. Engaging in natural conversations with real-time information.

FAQ from Claude MCP Server?

  • Can Claude MCP Server answer questions about current events?

Yes! It can provide real-time information by searching the web.

  • Is there a specific Python version required?

Yes, Python 3.9 or higher is required to run the server.

  • How do I set my Claude API key?

You can set your API key in the environment variables as specified in the setup instructions.

Content

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

No tools information available.
No content found.