Cricket Analytics MCP
🏏 Cricket Analytics MCP
ИИ-агент для анализа крикета, созданный с использованием Model Context Protocol (MCP), OpenAI, Python и Streamlit.
Проект позволяет пользователям изучать статистику крикета и задавать вопросы на естественном языке об игроках, командах, матчах и сравнениях игроков через интерфейс на основе ИИ.
✨ Возможности
🏏 Статистика игроков в крикет
📊 Анализ производительности игроков
⚔️ Сравнение двух игроков в крикет
🏆 Статистика и анализ команд
📅 Результаты матчей и последние матчи
📰 Поиск новостей о крикете
🤖 Крикетный аналитик на базе OpenAI
🔌 MCP-сервер для предоставления инструментов крикета
🎨 Интерактивный веб-интерфейс Streamlit
🔐 Конфигурация API-ключей через переменные окружения
Related MCP server: cricket-mcp
🏗️ Архитектура
┌─────────────────────┐
│ Streamlit UI │
│ streamlit_app.py │
└──────────┬──────────┘
│
▼
┌─────────────────────┐
│ OpenAI Agent │
│ agent_openai.py │
└──────────┬──────────┘
│
▼
┌─────────────────────┐
│ MCP Server │
│ server.py │
└──────────┬──────────┘
│
▼
┌─────────────────────┐
│ Data Provider │
│ data_provider.py │
└─────────────────────┘📁 Структура проекта
cricket-analytics-mcp/
│
├── agent_openai.py # OpenAI-powered cricket agent
├── data_provider.py # Cricket data and statistics provider
├── server.py # MCP server and cricket tools
├── streamlit_app.py # Streamlit frontend
│
├── screenshots/ # Application screenshots
│ ├── player-stats.png
│ ├── player-comparison.png
│ └── dashboard.png
│
├── .env # API keys and configuration (not committed)
├── .gitignore # Git ignored files
├── requirements.txt # Python dependencies
└── README.md # Project documentation🛠️ Технологический стек
Python
OpenAI API
Model Context Protocol (MCP)
Streamlit
python-dotenv
Источники статистики и данных по крикету
🔧 Инструменты MCP
MCP-сервер может предоставлять инструменты, ориентированные на крикет, такие как:
get_player_stats()
get_team_stats()
get_match_results()
get_player_comparison()
get_recent_matches()
search_cricket_news()Эти инструменты позволяют ИИ-агенту получать структурированную информацию о крикете и использовать её для ответа на вопросы пользователей.
💬 Примеры запросов
Show me Virat Kohli's ODI statistics.
Compare Virat Kohli and Rohit Sharma in ODI cricket.
Show me the recent matches of India.
Give me the Test statistics of Virat Kohli.
Compare the performance of two cricket players.
Show recent cricket news.⚙️ Установка
1. Клонируйте репозиторий
git clone https://github.com/YOUR_USERNAME/cricket-analytics-mcp.git
cd cricket-analytics-mcp2. Создайте виртуальное окружение
Windows:
python -m venv .venv
.venv\Scripts\activate3. Установите зависимости
pip install -r requirements.txt4. Настройте переменные окружения
Создайте файл .env в корне проекта:
OPENAI_API_KEY=your_openai_api_key
OPENAI_MODEL=gpt-5.6
CRICAPI_KEY= xxxxxxxНикогда не загружайте ваш файл .env на GitHub.
▶️ Запуск приложения
Запуск приложения Streamlit
streamlit run streamlit_app.pyЗатем откройте локальный URL-адрес Streamlit, показанный в вашем терминале.
Запуск MCP-сервера
Если ваш проект настроен на запуск MCP-сервера отдельно:
python server.pyСледуйте конфигурации MCP, используемой вашим клиентом/агентом.
🧪 Рабочий процесс проекта
User Question
↓
Streamlit Interface
↓
OpenAI Agent
↓
MCP Tool Selection
↓
MCP Server
↓
Cricket Data Provider
↓
Structured Cricket Data
↓
OpenAI Analysis
↓
Streamlit Response🔐 Переменные окружения
Переменная Описание
OPENAI_API_KEY Ключ API OpenAI
OPENAI_MODEL Модель OpenAI, используемая агентом
CRICAPI_KEY Ключ Cric API
Пример:
OPENAI_API_KEY=sk-xxxxxxxx
OPENAI_MODEL=gpt-5.6
CRICAPI_KEY= xxxxxxx📸 Скриншоты
Добавьте скриншоты приложения в каталог screenshots/.
Рекомендуемые скриншоты:
Статистика игроков
Сравнение игроков
Панель аналитики крикета
Затем укажите их в этом README:

🚀 Будущие улучшения
Живые счета крикета
Живой комментарий к матчам
Рейтинги игроков
Расширенные диаграммы сравнения игроков
Аналитика производительности команд
Анализ исторических матчей
Агрегация новостей о крикете
Больше инструментов MCP
Улучшенные визуализации панели
Развертывание в Streamlit Community Cloud
🎯 Варианты использования
Этот проект можно использовать для:
Изучения статистики крикета
Анализа производительности игроков
Исследований крикета на основе ИИ
Визуализации данных о крикете
Изучения и экспериментов с MCP
Разработки портфолио агентного ИИ
👨💻 Автор
Manas Ranjan Meher
This server cannot be deployed
Maintenance
Related MCP Connectors
Query your warehouse or a CSV with Claude/ChatGPT over MCP, governed by table-level ACL + audit.
Connect your ads, shop, analytics, social, CRM and finance platforms once, then let Claude, ChatGPT, Cursor or any MCP client read, join and explain your numbers. Public statistics from the World Bank, IMF, Eurostat, OECD, WHO and SEC filings come as context, searchable and chartable from the same tools. Read-only by design, every number carries its source.
Analytics for MCP servers. Query your tool calls, first-call success, retries and schema cost.
Official Microsoft MCP Server to query Microsoft Entra data using natural language
Related MCP Servers
- FlicenseBqualityDmaintenanceProvides natural language access to IPL cricket match data, allowing users to query player statistics, team performances, and match results. It utilizes a SQLite backend and Cricsheet data to deliver detailed cricket analytics through the Model Context Protocol.1-
- FlicenseNot gradedqualityBmaintenanceAn MCP server that enables natural language querying of over 10 million ball-by-ball cricket deliveries stored in a local DuckDB database. It provides 26 tools for analyzing player matchups, situational stats, and historical records across all major cricket formats and tournaments.2-
- AlicenseAqualityDmaintenanceEnables users to query MLB Statcast, FanGraphs, and Baseball Reference data using natural language through an AI assistant. It provides comprehensive tools for analyzing player performance, pitch-level data, season leaderboards, and team standings.2436MIT
- AlicenseNot gradedqualityBmaintenanceWraps CricAPI to provide live cricket data, enabling AI agents to query cricket information through natural language or direct tool calls.17 npmMIT