mcp-agent

AI 에이전트가 GitHub, Jira, Azure DevOps, Slack, PagerDuty, Linear, Notion, HuggingFace, OpenWeather 등 9개 플랫폼의 34개 도구에 접근할 수 있게 해주는 멀티 서비스 MCP(Model Context Protocol) 서버입니다.

탭과 대시보드를 오가는 대신, 일상적인 영어로 AI 어시스턴트에게 말하면 AI가 이러한 시스템을 직접 조회하거나 작업을 수행합니다.

Claude, GPT-4o, Azure OpenAI 및 모든 MCP 호환 클라이언트에서 작동합니다.

MCP란 무엇인가요?

Model Context Protocol은 Anthropic이 제정한 개방형 표준으로, AI 모델이 외부 도구 및 API와 구조적이고 안전한 방식으로 통신할 수 있게 해줍니다. AI는 대화에 머물면서도 실제 시스템에 접근하여 데이터를 가져오거나 작업을 수행할 수 있으며, 어떤 도구를 어떤 순서로 호출할지 자율적으로 결정합니다.

→ 상세 작동 방식

Related MCP server: GitBridge

서비스 및 도구

GitHub

Jira

Azure DevOps

Slack

PagerDuty

Linear

Notion

HuggingFace

OpenWeather

사용 사례 예시

크로스 서비스 추론

"이번 주 Azure DevOps 파이프라인 실패와 관련된 열린 Jira 버그가 있는지 확인한 후, 이를 요약하는 GitHub 이슈를 생성하세요."

에이전트는 jira_search_issues → ado_get_pipeline_runs → create_issue를 자율적으로 호출합니다.

인시던트 대응

"결제 서비스에 활성 PagerDuty 인시던트가 있습니다. 해당 저장소에 병합된 최신 PR을 찾아 #incidents Slack 채널에 알리세요."

에이전트는 pagerduty_get_incidents → get_pull_requests → slack_send_message를 호출합니다.

AI 리서치

"HuggingFace에서 가장 많이 다운로드된 텍스트 생성 모델을 찾은 다음, 1위 모델을 사용하는 프로젝트를 GitHub에서 검색하세요."

에이전트는 hf_search_models → search_repos를 호출합니다.

개발자 온보딩

"이 저장소의 상위 5명 기여자는 누구인가요? 그들의 GitHub 프로필을 가져와 팀을 요약하는 Notion 페이지를 만들어 주세요."

에이전트는 get_repo_contributors → get_user_profile (×5) → notion_create_page를 호출합니다.

→ 더 많은 사용 사례

설정

1. 클론 및 설치

git clone https://github.com/Abdessamad-Y/mcp-github-agent.git
cd mcp-github-agent
pip install -r requirements.txt

2. 서비스 구성

cp .env.example .env
# Add tokens only for the services you want to use
# Unused services are safely ignored

3. AI 클라이언트에 연결

→ 설정 가이드는 docs/integrations.md를 참조하세요:

• Claude Desktop — 네이티브 MCP, 코드 불필요

• Claude API — 에이전틱 루프가 포함된 Python 스크립트

• OpenAI (GPT-4o) — openai-agents SDK를 통해

• Azure OpenAI — OpenAI SDK + Azure 엔드포인트를 통해

• Cursor / VS Code Copilot

데모 실행

GITHUB_TOKEN=your_token python demo.py

포맷된 터미널 출력으로 4가지 라이브 시나리오를 실행합니다. AI API 키가 필요 없습니다.

예제 실행

# With Claude API
GITHUB_TOKEN=your_token ANTHROPIC_API_KEY=your_key python examples/with_claude.py

# With OpenAI
GITHUB_TOKEN=your_token OPENAI_API_KEY=your_key python examples/with_openai.py

# With Azure OpenAI
GITHUB_TOKEN=your_token \
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com \
AZURE_OPENAI_KEY=your_key \
AZURE_OPENAI_DEPLOYMENT=gpt-4o \
python examples/with_azure_openai.py

프로젝트 구조

mcp-github-agent/
├── server.py              # Entry point — registers all tools
├── mcp_instance.py        # Shared FastMCP instance
├── tools/
│   ├── github.py          # 11 GitHub tools
│   ├── jira.py            # 4 Jira tools
│   ├── azure_devops.py    # 4 Azure DevOps tools
│   ├── slack.py           # 3 Slack tools
│   ├── pagerduty.py       # 3 PagerDuty tools
│   ├── linear.py          # 3 Linear tools
│   ├── notion.py          # 3 Notion tools
│   ├── huggingface.py     # 3 HuggingFace tools
│   └── weather.py         # 2 OpenWeather tools
├── examples/
│   ├── with_claude.py
│   ├── with_openai.py
│   └── with_azure_openai.py
├── docs/
│   ├── how-it-works.md
│   ├── use-cases.md
│   └── integrations.md
├── demo.py
├── requirements.txt
└── .env.example

기술 스택

문서

라이선스

MIT