MCP 소개; MacOS에서 Keynote에 텍스트 추가 및 그리기

이 프로젝트는 모델 제어 프로토콜(MCP)을 사용하여 수학 계산을 수행하고 macOS의 Keynote에서 결과를 시각적으로 표시할 수 있는 수학 에이전트를 구현합니다. 에이전트는 Keynote 슬라이드에 도형을 그리고 텍스트를 추가할 수 있어 수학적 프레젠테이션을 만드는 데 유용합니다.

특징

• 수학 연산(덧셈, 뺄셈, 곱셈, 나눗셈 등)
• 고급 수학 함수(팩토리얼, 로그, 삼각 함수)
• ASCII 값 계산 및 지수 합 연산
• Keynote에서의 시각적 프레젠테이션:
  • 직사각형 그리기
  • 슬라이드에 텍스트 추가
  • 자동 슬라이드 관리

필수 조건

• 파이썬 3.x
• macOS(Keynote 통합용)
• 시스템에 Keynote가 설치되었습니다
• Google Gemini API 키

설치

1. 저장소를 복제합니다.

지엑스피1

2. 필요한 종속성을 설치하세요:

3. 프로젝트 루트에 .env 파일을 만들고 Gemini API 키를 추가하세요.

프로젝트 구조

• mcp-server.py : 수학 도구와 Keynote 통합을 통한 서버 구현이 포함되어 있습니다.
• mcp-client.py : LLM과 통신하고 워크플로를 관리하는 클라이언트를 구현합니다.
• requirements.txt : 모든 Python 종속성을 나열합니다.

용법

클라이언트 스크립트( mcp-client.py )는 MCP 서버 시작 및 통신을 자동으로 처리합니다. 다음과 같이 쿼리를 사용하여 클라이언트를 실행하기만 하면 됩니다.

예를 들어:

쿼리가 제공되지 않으면 스크립트는 위 예에서 언급된 기본 쿼리를 사용합니다.

클라이언트는 다음을 수행합니다.

1. 백그라운드에서 MCP 서버를 자동으로 시작합니다.
2. Keynote를 열고 새 문서를 만듭니다.
3. 요청된 수학 연산을 수행합니다.
4. 슬라이드에 사각형을 그립니다
5. 사각형 안에 결과를 텍스트로 추가합니다.

참고: MCP 서버는 클라이언트 스크립트에 의해 내부적으로 관리되므로 수동으로 시작할 필요가 없습니다. 서버는 모든 수학 연산과 Keynote 상호작용을 처리하고, 클라이언트는 언어 모델과의 통신을 관리하고 전체 워크플로를 조율합니다.

사용 가능한 수학 도구

• 기본 작업:
  • 추가( add )
  • 뺄셈( subtract )
  • 곱셈( multiply )
  • 나누기( divide )
  • 파워( power )
  • 제곱근( sqrt )
  • 세제곱근( cbrt )
• 고급 작업:
  • 팩토리얼( factorial )
  • 자연로그( log )
  • 나머지 ( remainder )
  • 삼각 함수( sin , cos , tan )
  • 피보나치 수열( fibonacci_numbers )
  • ASCII 값 계산( strings_to_chars_to_int )
  • 지수 합( int_list_to_exponential_sum )

키노트 통합

이 프로젝트에는 Keynote 통합을 위한 도구가 포함되어 있습니다.

• mac_open_keynote : Keynote를 열고 새 문서를 만듭니다.
• mac_draw_rectangle : 현재 슬라이드에 사각형을 그립니다.
• mac_add_text_in_keynote : 현재 슬라이드에 텍스트를 추가합니다.

오류 처리

이 시스템에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

• API 통신 문제
• 잘못된 수학 연산
• Keynote 통합 문제
• LLM 응답에 대한 시간 초과 처리

도구

• 프레임워크를 위한 모델 제어 프로토콜(MCP)
• 언어 모델을 위한 Google Gemini
• 프레젠테이션 플랫폼을 위한 Apple Keynote

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.