mcpField
C
Claude MCP Server

Claude MCP Server

Local
github.com/risherbAI & Agents1Updated 81w ago
Repository

About Claude MCP Server

Claude MCP Server is a Flask-based server and client setup that lets Claude search the web through DuckDuckGo during conversations. It also provides a command-line interface for asking current-events and technical questions.

Key features

  1. 01DuckDuckGo web search
  2. 02Claude 3 API and tool-use support
  3. 03Command-line interaction
  4. 04Health check and server information endpoints

Use cases

  1. 01Look up recent events
  2. 02Search for current information on technical topics

MCP support

The MCP server handles tool calls and runs DuckDuckGo searches; the project also includes a client that connects to Claude's API and manages tool use.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.