긱봇 MCP

LLM 애플리케이션에서 Geekbot 데이터를 잠금 해제하세요 🚀

Geekbot MCP(모델 컨텍스트 프로토콜) 서버는 LLM 클라이언트 애플리케이션(예: Claude)을 Geekbot 작업 공간에 직접 연결하는 브리지 역할을 합니다. 이를 통해 대화 내에서 자연어를 사용하여 스탠드업, 보고서 및 팀원과 원활하게 소통할 수 있습니다.

주요 특징 ✨

• 스탠드업 정보 액세스 : Geekbot 작업 공간에 있는 모든 스탠드업을 나열하세요. 📊
• 스탠드업 보고서 검색 : 특정 스탠드업, 사용자 또는 날짜 범위에 대한 필터가 있는 보고서를 가져옵니다. 📄
• 팀원 보기 : Geekbot에서 협업하는 팀원 목록을 확인하세요. 👥

설치 💻

Python 3.10 이상 및 uv 필요합니다.

1. uv를 설치하세요(아직 설치하지 않았다면):지엑스피1(더 많은 옵션은 uv 설치 문서를 참조하세요.)
2. Geekbot MCP 설치:
   uv tool install geekbot-mcp

업그레이드 ⬆️

최신 버전으로 업데이트하려면:

구성 ⚙️

Geekbot MCP를 LLM(예: Claude Desktop)에 연결합니다.

1. Geekbot API 키를 받으세요: Geekbot API/웹훅 설정 에서 찾으세요.
2. uv 실행 파일 경로를 찾으세요:
   which uv
3. LLM 클라이언트 애플리케이션 구성: Geekbot MCP 서버를 추가하려면 claude_desktop_config.json (또는 다른 MCP 클라이언트의 동등한 구성 파일)을 편집하세요.
   { "globalShortcut": "", "mcpServers": { // Add or update this section "geekbot-mcp": { "command": "<path-returned-by-which-uv>", // Replace with your actual uv path "args": [ "tool", "run", "geekbot-mcp" ], // Environment variables needed by the server "env": { "GB_API_KEY": "<your-geekbot-api-key>" // Replace with your actual API key } } // ... other MCP servers if any } // ... other configurations }
   (클라이언트 구성에 대한 자세한 내용은 MCP 빠른 시작을 참조하세요.)

사용법 💡

구성이 완료되면 LLM 클라이언트 애플리케이션은 다음 도구와 프롬프트에 액세스하여 Geekbot 데이터와 상호 작용할 수 있습니다.

도구 🛠️

• list_standups

목적: API 키를 통해 접속 가능한 모든 스탠드업을 나열합니다. 개요를 확인하거나 특정 스탠드업 ID를 찾는 데 유용합니다.

예시 프롬프트: "안녕하세요, 제 Geekbot 스탠드업을 나열해 주시겠어요?"

반환된 데이터 필드:

• id : 고유한 스탠드업 식별자.
• name : 스탠드업의 이름.
• channel : 연관된 커뮤니케이션 채널(예: Slack 채널).
• time : 스탠드업 보고를 위한 예정된 시간입니다.
• timezone : 예약된 시간의 시간대.
• questions : 스탠드업에서 묻는 질문 목록입니다.
• participants : 스탠드업에 참여하는 사용자 목록입니다.
• owner_id : 스탠드업 소유자의 ID입니다.
• fetch_reports

목적: 특정 스탠드업 보고서를 검색합니다. 스탠드업, 사용자 및 날짜 범위별로 필터링할 수 있습니다.

예시 프롬프트:

• "어제 제출한 회고 보고서를 가져와."
• "'주간 동기화' 스탠드업에 대한 사용자 John Doe의 보고서를 보여주세요."
• "2024년 6월 1일 이후에 Daily Standup 스탠드업에 제출된 모든 보고서를 받으세요."

사용 가능한 필터:

• standup_id : 특정 스탠드업 ID로 필터링합니다.
• user_id : 특정 사용자 ID로 보고서를 필터링합니다.
• after : 이 날짜(YYYY-MM-DD) 이후에 제출된 보고서를 검색합니다. 🗓️.
• before : 이 날짜(YYYY-MM-DD) 이전에 제출된 보고서를 검색합니다. 🗓️.

반환된 데이터 필드:

• id : 고유한 보고서 식별자.
• reporter_name : 보고서를 제출한 사용자의 이름입니다.
• reporter_id : 보고서를 제출한 사용자의 ID입니다.
• standup_id : 보고서가 속한 스탠드업의 ID입니다.
• created_at : 보고서가 제출된 타임스탬프입니다.
• content : 보고서의 실제 답변/내용입니다.
• list_members

목적: Geekbot 작업 공간에서 스탠드업을 공유하는 모든 팀원을 나열합니다.

예시 프롬프트: "Geekbot 작업 공간의 멤버는 누구인가요?"

반환된 데이터 필드:

• id : 회원의 고유 식별자.
• name : 회원의 성명을 기재합니다.
• email : 회원의 이메일 주소입니다.
• role : Geekbot 내에서의 멤버 역할(예: 관리자, 멤버).

프롬프트 💬

• weekly_rollup_report

목적: 팀 스탠드업 응답을 요약하고, 주요 업데이트를 강조하고, 위험과 완화 전략을 파악하고, 다음 단계를 설명하고, 다가올 출시를 추적하는 포괄적인 주간 롤업 보고서를 생성합니다.

인수:

• standup_id : 롤업 보고서에 포함할 스탠드업의 ID입니다.

개발 🧑‍💻

로컬에서 서버를 운영하거나 기여하는 데 관심이 있으신가요?

개발 환경 설정

테스트 실행 ✅

기여하기 🤝

기여를 환영합니다! 저장소를 포크하고 변경 사항을 담은 풀 리퀘스트를 제출해 주세요.

라이센스 📜

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여되었습니다.

감사의 말 🙏

• Anthropic Model Context Protocol 프레임워크를 기반으로 구축되었습니다.
• 공식 Geekbot API를 활용합니다.