MCP ExplorerExplorer

Agent With Mcp

@Akashr-18on a year ago
1 MIT
FreeCommunity
AI Systems
Creating this sample repo to showcase my knowledge

Overview

What is Agent With Mcp

Agent_with_MCP is a full-stack AI agent system that utilizes the Model Context Protocol (MCP) to facilitate real-time web searches through a Python CLI, powered by the Claude LLM.

Use cases

Use cases include providing instant answers to user queries, conducting research, enhancing user engagement in applications, and automating information retrieval tasks.

How to use

To use Agent_with_MCP, users can input their queries into the Python CLI, which triggers the Claude LLM to process the request, interact with the MCPClient, and execute web searches via the DuckDuckGo API.

Key features

Key features include real-time tool interaction via Claude, standardized communication through MCP, structured request management with ClaudeClient and MCPClient, DuckDuckGo API integration for live searches, natural language to structured search intent conversion, and a Flask-based MCP server for secure tool handling.

Where to use

Agent_with_MCP can be used in various fields such as customer support, information retrieval, educational tools, and any application requiring real-time data access and processing.

Content

🤖 Full-Stack AI Agent System using Model Context Protocol (MCP)

This project demonstrates a fully functional AI Agent System built from scratch using the Model Context Protocol (MCP) to enable real-time DuckDuckGo web searches via a Python CLI, orchestrated through the Claude LLM.

It showcases a modern approach to building LLM-tool integrations using a standardized communication protocol (MCP), dynamic tool calling, and local Flask server infrastructure.


🔍 Overview

The system allows a Claude-powered agent to perform real-time searches by interacting with external tools using the MCP standard. The agent can:

  • Understand user queries
  • Trigger structured tool calls
  • Execute web searches using the DuckDuckGo API
  • Return a summarized response back to the user

🧠 Core Features

  • 🔄 Real-time Tool Interaction via Claude using MCP
  • 🧩 Model Context Protocol (MCP) for standardized LLM-tool communication
  • 🧠 ClaudeClient + MCPClient layers to manage structured requests
  • 🌐 DuckDuckGo API Integration for live web search
  • 🧪 Natural Language → Structured Search Intent conversion
  • 🧰 Flask-based MCP Server for secure tool call handling

🏗️ Architecture

User Query
   ↓
Claude LLM ←→ ClaudeClient (CLI)
   ↓
MCPClient → Local Flask MCP Server
   ↓
Tool Execution Layer → DuckDuckGo API
   ↓
Results → MCPClient → Claude (Summarization) → User

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers