🤖 AI Blog MCP Agent

A local AI-powered research agent that searches the web, fetches real content, and generates grounded answers using a local Ollama model — exposed as an MCP (Model Context Protocol) tool for Claude Desktop.

🧠 How It Works

Query → Summarize → Generate Search Query → Tavily Search → Fetch Docs → Grounded Answer

Related MCP server: Perplexity Tool for Claude Desktop

🚀 Features

• 🔍 Real-time web search via Tavily API

• 🧹 Automatic content cleaning (removes scripts, navbars, footers)

• 🚫 Blocked domain filtering (Medium, YouTube, Twitter, Reddit)

• 🤖 Local LLM inference via Ollama

• 🔌 MCP tool integration for Claude Desktop

• 🧪 Test mode for quick pipeline validation

📦 Requirements

• Python 3.10+

• Ollama running locally with gpt-oss:120b-cloud model

• Tavily API key — get one at app.tavily.com

🛠️ Installation

1. Clone the repo:

git clone https://github.com/BhavinXAgheda/AI_Blog_MCP_Agent.git
cd AI_Blog_MCP_Agent

2. Create and activate virtual environment:

python -m venv venv
source venv/bin/activate        # Mac/Linux
venv\Scripts\activate           # Windows

3. Install dependencies:

pip install fastmcp ollama tavily-python requests beautifulsoup4 python-dotenv

4. Create .env file:

cp .env.example .env

Then edit .env and add your Tavily API key:

TAVILY_API_KEY=your-tavily-api-key-here

▶️ Usage

Test the pipeline:

python test.py test

Start as MCP server:

python test.py

🔌 Claude Desktop Integration

Add this to your claude_desktop_config.json:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "blog-agent": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/AI_Blog_MCP_Agent/test.py"]
    }
  }
}

Replace the paths with your actual venv and project paths, then restart Claude Desktop.

You can then ask Claude:

"Research the latest AI news in March 2026"

And it will call your local agent to search, fetch, and answer using live web data.

📁 Project Structure

AI_Blog_MCP_Agent/
├── test.py           # Main agent + MCP server
├── .env              # Your API keys (never committed)
├── .env.example      # Template for environment variables
├── .gitignore        # Ignores .env, venv, __pycache__
└── README.md         # This file

🔐 Environment Variables

🚫 Blocked Domains

The following domains are skipped during doc fetching (paywalled or JS-heavy):

• medium.com

• youtube.com

• twitter.com

• reddit.com

You can extend the BLOCKED_DOMAINS list in test.py as needed.

🧪 Example Output

Query:        How do I handle file uploads in Next.js 14?
Search Query: Next.js 14 file upload handling
Summary:      The user is asking for a guide on implementing file upload...
URLs:         ['https://oneuptime.com/blog/...', 'https://dev.to/...']
Docs fetched: 2
Answer:       ## Handling File Uploads in Next.js 14 ...

📄 License

MIT License — feel free to use, modify, and distribute.

🙌 Built With

• FastMCP — MCP server framework

• Ollama — Local LLM inference

• Tavily — Web search API

• BeautifulSoup4 — HTML parsing