Skip to main content
Glama
manasranjanmeher99

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-mcp

2. Создайте виртуальное окружение

Windows:

python -m venv .venv
.venv\Scripts\activate

3. Установите зависимости

pip install -r requirements.txt

4. Настройте переменные окружения

Создайте файл .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:

![Player Statistics](screenshots/player-stats.png)

![Player Comparison](screenshots/player-comparison.png)

🚀 Будущие улучшения

  • Живые счета крикета

  • Живой комментарий к матчам

  • Рейтинги игроков

  • Расширенные диаграммы сравнения игроков

  • Аналитика производительности команд

  • Анализ исторических матчей

  • Агрегация новостей о крикете

  • Больше инструментов MCP

  • Улучшенные визуализации панели

  • Развертывание в Streamlit Community Cloud

🎯 Варианты использования

Этот проект можно использовать для:

  • Изучения статистики крикета

  • Анализа производительности игроков

  • Исследований крикета на основе ИИ

  • Визуализации данных о крикете

  • Изучения и экспериментов с MCP

  • Разработки портфолио агентного ИИ

👨💻 Автор

Manas Ranjan Meher

F
license - not found
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    B
    quality
    C
    maintenance
    Provides 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
  • F
    license
    Not graded
    quality
    B
    maintenance
    An 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
  • A
    license
    A
    quality
    D
    maintenance
    Enables 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.
    24
    34
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Wraps CricAPI to provide live cricket data, enabling AI agents to query cricket information through natural language or direct tool calls.
    10
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/manasranjanmeher99/Cricket_Analyst_MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server