Skip to main content
Glama
manasranjanmeher99

Cricket Analytics MCP

🏏 크리켓 분석 MCP

Model Context Protocol (MCP), OpenAI, Python, Streamlit로 구축된 AI 기반 크리켓 분석 에이전트입니다.

이 프로젝트는 사용자가 AI 기반 인터페이스를 통해 크리켓 통계를 탐색하고 선수, 팀, 경기, 선수 비교에 대해 자연어로 질문할 수 있게 해줍니다.

✨ 주요 기능

  • 🏏 크리켓 선수 통계

  • 📊 선수 성과 분석

  • ⚔️ 두 크리켓 선수 비교

  • 🏆 팀 통계 및 분석

  • 📅 경기 결과 및 최근 경기

  • 📰 크리켓 뉴스 검색

  • 🤖 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()

이러한 도구를 통해 AI 에이전트는 구조화된 크리켓 정보를 검색하고 이를 사용자 질문에 답하는 데 활용할 수 있습니다.

💬 예시 질문

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

그런 다음 터미널에 표시된 로컬 Streamlit URL을 여세요.

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 OpenAI API 키 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 배포

🎯 사용 사례

이 프로젝트는 다음 용도로 사용할 수 있습니다:

  • 크리켓 통계 탐색

  • 선수 성과 분석

  • AI 기반 크리켓 리서치

  • 크리켓 데이터 시각화

  • MCP 학습 및 실험

  • 에이전트형 AI 포트폴리오 개발

👨💻 저자

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