MCP Tools Reference: classroommcp.googleapis.com

Narzędzie: search_course_standards

Wyszukuje standardy nauczania akademickiego na kursie, aby oznaczyć tagiem materiały dydaktyczne lub oceny cząstkowe. Wymaga, aby nauczyciel skonfigurował standardy nauczania na zajęciach.

  • Konkretne standardy: wyszukaj według dokładnego kodu (np. „HS-LS1-1”) lub konkretnych słów kluczowych (includeGroupingStandards=false).
  • Kategorie: ustaw parametr includeGroupingStandards=true z ogólnym słowem tematycznym, aby znaleźć kategorie nadrzędne, a następnie przekaż identyfikator kategorii do parametru learningStandardIds, aby zawęzić wyniki.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia MCP search_course_standards.

Żądanie curl
curl --location 'https://classroommcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_course_standards",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat wejściowy

Wyślij prośbę o wyszukiwanie we wstępnie wybranych drzewach standardów nauczania na poziomie kursu.

SearchCourseStandardsRequest

Zapis JSON
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
Pola
courseId

string

Wymagane. Identyfikator kursu.

learningStandardIds[]

string

Opcjonalnie: Ogranicza wyszukiwanie do tych zestawów standardów lub standardów kategorii i ich elementów podrzędnych. Przekaż identyfikator zestawu standardów z Course.learning_goals (w list_courses) lub identyfikatory kategorii z poprzedniego wywołania z includeGroupingStandards = true (nie standardCode), ale nie obie te wartości. Jeśli pole jest puste, wyszukiwane są wszystkie standardy w ramach zajęć.

query

string

Wymagane. Wyszukiwane hasła, wielkość liter nie jest rozróżniana. Wyniki muszą zawierać WSZYSTKIE słowa rozdzielone spacjami w kodzie lub instrukcji. – Gdy includeGroupingStandards = false: podaj dokładny kod standardu (np. „HS-LS1-1”) lub 2–3 konkretne słowa kluczowe (np. „pole trójkąta”). – Gdy includeGroupingStandards = true: przekaż 1–2 słowa kluczowe w dopasowaniu przybliżonym (np. „geometria”) pasujące do tytułów kategorii.

includeGroupingStandards

boolean

Opcjonalnie: Jeśli ma wartość „true”, zwraca nagłówki kategorii (których nie można oznaczyć tagiem materiałów dydaktycznych), których identyfikatory zawężają kolejne wyszukiwania. Jeśli ma wartość false (domyślnie), zwraca standardy, które można oznaczyć w materiałach dydaktycznych.

Schemat wyjściowy

Odpowiedź zawierająca standardy nauczania.

SearchCourseStandardsResponse

Zapis JSON
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
Pola
learningStandards[]

object (LearningGoal)

Lista pasujących standardów.

LearningGoal

Zapis JSON
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
Pola
id

string

Tylko dane wyjściowe. Identyfikator celu edukacyjnego. Aby dołączyć standard, użyj id z search_course_standards (nie standardCode).

type

enum (Type)

Tylko dane wyjściowe. Typ celu edukacyjnego.

standardCode

string

Tylko dane wyjściowe. Kod standardu (np. „NY-2.NBT.4”). Wartość jest podawana tylko w przypadku standardów.

title

string

Tylko dane wyjściowe. Opis oświadczenia dotyczącego standardów lub zrozumiały dla człowieka tytuł dotyczący umiejętności.

documentTitle

string

Tylko dane wyjściowe. Nazwa dokumentu programu nauczania. Wartość jest podawana tylko w przypadku standardów.

Typ

Typ celu edukacyjnego.

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślony typ celu edukacyjnego.
STANDARD Standard nauczania z programu akademickiego.
SKILL Umiejętność reprezentująca koncepcję lub kompetencję edukacyjną. Tylko nauczyciel może dodawać i usuwać umiejętności w Classroom.

Adnotacje dotyczące narzędzi

Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy wysłać użytkownikowi prośbę o potwierdzenie.

Oprócz ciągu tytułu zdefiniowane są te wskazówki logiczne:

  • readOnlyHint: jeśli ma wartość „true”, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: false.
  • destructiveHint: jeśli ma wartość „true”, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodawania. Wartość domyślna: true.
  • idempotentHint: jeśli ma wartość „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: false.
  • openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z elementami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie jest narzędziem typu Otwarty świat, a narzędzie do zapamiętywania – nie.

Wskazówka dotycząca destrukcyjności: ❌ | Wskazówka dotycząca idempotencji: ✅ | Wskazówka dotycząca tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly