🔍 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_research_server.py and add entries to the data dictionaries:

• competitors_db (line ~70)

• business_data (line ~100)

• industry_keywords (line ~140)

Using Real APIs

For production use, replace the sample data with real API calls:

• Business data APIs (Crunchbase, PitchBook)

• Financial APIs (Alpha Vantage, Yahoo Finance)

• News APIs (NewsAPI, Google News)

• Web scraping (requests + BeautifulSoup)

Changing OpenAI Model

In gradio_app.py, modify the model parameter:

model="gpt-4o-mini"  # Change to "gpt-4o", "gpt-4-turbo", etc.

📊 Project Structure

mcp2_test/
├── README.md                    # This file
├── requirements.txt             # Python dependencies
├── .env.example                 # Environment variables template
├── setup.sh                     # Setup script
├── mcp_research_server.py       # MCP server with research tools
└── gradio_app.py               # Gradio web application

🐛 Troubleshooting

"Module not found" errors

pip install -r requirements.txt

"Invalid API key" error

• Check your OpenAI API key in the input field

• Ensure you have credits in your OpenAI account

• Verify the key starts with sk-

Port already in use

Change the port in gradio_app.py:

demo.launch(server_port=7861)  # Use different port

🚀 Future Enhancements

• Real-time web scraping for live data

• Integration with business intelligence APIs

• Export reports to PDF/CSV

• Historical trend analysis

• Multi-company comparison view

• Financial metrics integration

• News sentiment analysis

• Custom report templates

📝 License

This project is provided as-is for educational and research purposes.

🤝 Contributing

Contributions welcome! Feel free to:

• Add more MCP tools

• Improve the UI/UX

• Integrate additional APIs

• Enhance the AI prompts

• Add export functionality

💡 Learn More

• FastMCP Documentation

• Gradio Documentation

• OpenAI API Reference

• Model Context Protocol

Built with ❤️ using FastMCP, OpenAI, and Gradio