Google 작업 MCP 서버

Google Tasks를 관리하기 위한 MCP(Model Context Protocol) 서버입니다.

이 TypeScript 기반 MCP 서버는 Google Tasks API와 통합되어 핵심 MCP 개념을 보여줍니다. 체계적이고 효율적인 작업 관리를 지원합니다.

특징

자원

• 기본 작업 목록 : URI tasks://default 통해 기본 Google 작업 목록의 작업에 액세스합니다.

• 작업 세부 정보 : 제목, 메모, 완료 상태 등 작업에 대한 메타데이터를 제공합니다.

• JSON MIME 유형 : 작업은 기계가 읽을 수 있는 JSON 형식으로 표현됩니다.

도구

• create_task : 기본 작업 목록에 새 작업을 만듭니다.

  • 매개변수 :

    • title (문자열, 선택 사항): 작업의 제목입니다.

    • notes (문자열, 선택 사항): 작업에 대한 추가 메모입니다.

    • taskId (문자열, 선택 사항): 작업에 대한 고유 ID입니다.

    • status (문자열, 선택 사항): 작업의 상태(예: "needsAction" 또는 "completed").

  • 응답 : 생성된 작업의 세부 정보를 반환합니다.

• list_tasks : 기본 작업 목록에 있는 모든 작업을 나열합니다.

  • 매개변수 : 없음.

  • 응답 : 기본 작업 목록에 있는 모든 작업의 JSON 배열을 반환합니다.

• delete_task : 기본 작업 목록에서 작업을 삭제합니다.

  • 매개변수 :

    • taskId (문자열, 필수): 삭제할 작업의 ID입니다.

  • 응답 : 작업이 성공적으로 삭제되었음을 확인합니다.

• update_task : 기본 작업 목록에서 기존 작업을 업데이트합니다.

  • 매개변수 :

    • taskId (문자열, 필수): 업데이트할 작업의 ID입니다.

    • title (문자열, 선택 사항): 작업의 새로운 제목입니다.

    • notes (문자열, 선택 사항): 작업에 대한 새로운 메모입니다.

  • 응답 : 작업의 업데이트된 세부 정보를 반환합니다.

• complete_task : 작업의 완료 상태를 전환합니다.

  • 매개변수 :

    • taskId (문자열, 필수): 완료 상태를 전환할 작업의 ID입니다.

  • 응답 : 새로운 상태를 포함한 업데이트된 작업 세부 정보를 반환합니다.

Related MCP server: MCP Server

기능성

• MCP를 통해 대규모 언어 모델(LLM)이나 다른 애플리케이션과 쉽게 통합할 수 있습니다.

• 체계적인 도구 정의를 통해 작업 관리가 직관적이고 접근하기 쉬워집니다.

• 작업 생성, 나열, 삭제, 업데이트 및 완료 상태 전환을 완벽하게 지원합니다.

용법

서버 실행

서버를 시작하려면:

지엑스피1

사용 가능한 명령

• create_task : 선택적 매개변수를 사용하여 새로운 작업을 만듭니다.

  {
    "title": "Complete project",
    "notes": "Finalize module 3",
    "status": "needsAction"
  }

• list_tasks : 기본 작업 목록에 있는 모든 작업을 검색합니다.

  • 매개변수가 필요하지 않습니다.

  • 작업 배열을 반환합니다.

• delete_task : ID로 작업을 삭제합니다.

  {
    "taskId": "unique-task-id"
  }

• update_task : ID를 기준으로 작업의 제목, 메모 또는 기타 세부 정보를 업데이트합니다.

  {
    "taskId": "unique-task-id",
    "title": "Updated task title",
    "notes": "Updated task notes"
  }

• complete_task : 작업의 완료 상태를 전환합니다.

  {
    "taskId": "unique-task-id"
  }

complete_task 에 대한 응답 예시

완료 전

{
  "taskId": "unique-task-id",
  "title": "Finish the report",
  "status": "needsAction"
}

완료 후

{
  "taskId": "unique-task-id",
  "title": "Finish the report",
  "status": "completed"
}

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅에는 추가 도구가 필요합니다. MCP Inspector 사용을 권장합니다.

검사기를 시작하려면:

npm run inspector

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공하여 서버를 더 쉽게 테스트하고 디버깅할 수 있도록 해줍니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다.