MCP Research Server MCP Server

🔍 Company Research Agent with MCP + OpenAI + Gradio

An intelligent company research and competitive analysis tool that combines the power of Model Context Protocol (MCP), OpenAI GPT-4, and Gradio to deliver comprehensive business intelligence.

🌟 Features

• Automated Company Research: Search for company information using MCP tools
• Competitor Analysis: Automatically identify and analyze competitors
• Business Model Analysis: Understand company operations and revenue streams
• Market Keywords Extraction: Extract relevant keywords describing the competitive landscape
• AI-Powered Insights: OpenAI synthesizes research into actionable executive summaries
• Interactive UI: Beautiful Gradio interface for easy interaction

🏗️ Architecture

┌─────────────────┐
│  Gradio UI      │
│  (Frontend)     │
└────────┬────────┘
         │
         ▼
┌─────────────────┐      ┌──────────────────┐
│  OpenAI GPT-4   │◄────►│  MCP Server      │
│  (AI Analysis)  │      │  (Research Tools)│
└─────────────────┘      └──────────────────┘
                                   │
                         ┌─────────┴─────────┐
                         │  Research Tools:  │
                         │  • Company Info   │
                         │  • Competitors    │
                         │  • Business Model │
                         │  • Keywords       │
                         └───────────────────┘

📋 Components

1. MCP Research Server (`mcp_research_server.py`)

FastMCP server providing research tools:

• search_company_info() - Search for basic company information
• find_competitors() - Find competitor companies
• analyze_company_business() - Analyze business model and activities
• extract_market_keywords() - Extract market and industry keywords
• generate_competitive_report() - Generate full competitive analysis

2. Gradio Application (`gradio_app.py`)

Interactive web interface that:

• Accepts company name and OpenAI API key as inputs
• Orchestrates MCP tool calls for data gathering
• Uses OpenAI to generate intelligent summaries
• Displays results in an organized, user-friendly format

🚀 Quick Start

Prerequisites

• Python 3.8 or higher
• OpenAI API key (Get one here)

Installation

1. Clone or download this repository

2. Run the setup script:

   chmod +x setup.sh
   ./setup.sh
   

3. Configure your API key:

   cp .env.example .env
   # Edit .env and add your OpenAI API key
   

Manual Installation

If you prefer manual setup:

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

💻 Usage

Start the Application

# Activate virtual environment (if not already active)
source venv/bin/activate

# Run the Gradio app
python gradio_app.py

The application will start on http://localhost:7860

Using the Interface

1. Enter a company name (e.g., "Apple", "Tesla", "Netflix")
2. Enter your OpenAI API key (required for AI analysis)
3. Click "Research Company" to start the analysis
4. View results:
   • Executive Summary (AI-generated)
   • Full Report (expand accordion)
   • Market Keywords (expand accordion)

Example Companies to Try

• Technology: Apple, Microsoft, Google, Amazon, Meta
• Automotive: Tesla, Ford, General Motors
• Entertainment: Netflix, Disney
• Consumer Goods: Nike, Coca-Cola, Starbucks

📦 Dependencies

• fastmcp - Model Context Protocol server framework
• gradio - Web UI framework
• openai - OpenAI API client
• requests - HTTP library for web requests
• beautifulsoup4 - HTML parsing (for future web scraping)
• python-dotenv - Environment variable management

🔧 How It Works

1. User Input: User enters company name in Gradio interface
2. MCP Tools: Application calls MCP research tools to gather data:
   • Company information from Wikipedia API
   • Competitor identification from database
   • Business model analysis
   • Market keyword extraction
3. AI Synthesis: OpenAI GPT-4 processes all research data and generates:
   • Executive summary
   • Key insights
   • Market positioning analysis
4. Results Display: Formatted report shown in Gradio UI

🎯 Use Cases

• Competitive Intelligence: Understand your competitors quickly
• Market Research: Identify market trends and keywords
• Investment Analysis: Research companies for investment decisions
• Business Strategy: Inform strategic planning with competitive data
• Sales Enablement: Prepare for sales conversations with prospect research

🔐 Security Notes

• Never commit your .env file or expose your OpenAI API key
• Use environment variables for sensitive information
• The .env.example file is provided as a template

🛠️ Customization

Adding More Companies

Edit `mcp_r