get-list-of-all-subjects

Retrieve all courses from ZEN University's syllabus with essential details like name, grade requirements, quarters offered, and credits to help students plan their curriculum.

Instructions

Retrieve a simplified list of all courses from the ZEN University syllabus, containing only the essential properties (name, enrollmentGrade, quarters, credit).

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

src/index.ts:217-263 (handler)

Handler function that fetches all subjects using fetchAllPages, simplifies the data, formats it to text using helper functions, and returns as text content.

async () => {
  try {
    const result = await fetchAllPages();
    
    // Extract only the required properties from each subject
    const simplifiedSubjects = result.subjects.map(subject => ({
      // code: subject.code,
      name: subject.name,
      // description: subject.description,
      // thumbnailUrl: subject.thumbnailUrl,
      openingYear: subject.openingYear,
      metadata: {
        enrollmentGrade: subject.metadata.enrollmentGrade,
        teachingMethod: subject.metadata.teachingMethod,
        subjectRequirement: subject.metadata.subjectRequirement,
        evaluationSystem: subject.metadata.evaluationSystem,
        credit: subject.metadata.credit,
        quarters: subject.metadata.quarters,
        objective: subject.metadata.objective,
        specialNotes: subject.metadata.specialNotes,
        coursePlans: subject.metadata.coursePlans || []
      },
      subjectCategoryIds: subject.subjectCategoryIds || []
    }));

    // テキスト形式に変換
    const formattedText = formatSimplifiedSubjectsToText(simplifiedSubjects);
    
    return {
      content: [
        {
          type: "text",
          text: formattedText,
        },
      ],
    };
  } catch (error) {
    return {
      content: [
        {
          type: "text",
          text: `Error: ${error}`,
        },
      ],
    };
  }
},

src/index.ts:212-264 (registration)

Registration of the get-list-of-all-subjects tool with server.tool, including name, description, empty input schema, and handler function.

server.tool(
  "get-list-of-all-subjects",
  "Retrieve a simplified list of all courses from the ZEN University syllabus, containing only the essential properties (name, enrollmentGrade, quarters, credit).",
  {},

  async () => {
    try {
      const result = await fetchAllPages();
      
      // Extract only the required properties from each subject
      const simplifiedSubjects = result.subjects.map(subject => ({
        // code: subject.code,
        name: subject.name,
        // description: subject.description,
        // thumbnailUrl: subject.thumbnailUrl,
        openingYear: subject.openingYear,
        metadata: {
          enrollmentGrade: subject.metadata.enrollmentGrade,
          teachingMethod: subject.metadata.teachingMethod,
          subjectRequirement: subject.metadata.subjectRequirement,
          evaluationSystem: subject.metadata.evaluationSystem,
          credit: subject.metadata.credit,
          quarters: subject.metadata.quarters,
          objective: subject.metadata.objective,
          specialNotes: subject.metadata.specialNotes,
          coursePlans: subject.metadata.coursePlans || []
        },
        subjectCategoryIds: subject.subjectCategoryIds || []
      }));

      // テキスト形式に変換
      const formattedText = formatSimplifiedSubjectsToText(simplifiedSubjects);
      
      return {
        content: [
          {
            type: "text",
            text: formattedText,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error: ${error}`,
          },
        ],
      };
    }
  },
);

src/index.ts:126-162 (helper)

Core helper function fetchAllPages that fetches all pages from the syllabus API, merges subjects from all pages.

async function fetchAllPages(options?: FetchOptions) {
  // まず最初のページを取得
  const firstPageUrl = createUrl(0, options);
  const firstResponse = await fetch(firstPageUrl);
  if (!firstResponse.ok) {
    throw new Error(`APIリクエストに失敗しました: ${firstResponse.status} ${firstResponse.statusText}`);
  }

  const firstData = (await firstResponse.json()) as ApiResponse;
  const allSubjects = [...firstData.subjects];
  const { totalPages, totalCount, pageSize, relatedTags } = firstData;

  // 2ページ目以降を順次取得 (page=1 ~ totalPages-1)
  for (let page = 1; page < totalPages; page++) {
    const url = createUrl(page, options);
    const response = await fetch(url);

    if (!response.ok) {
      throw new Error(`APIリクエストに失敗しました: ${response.status} ${response.statusText}`);
    }

    const data = (await response.json()) as ApiResponse;
    allSubjects.push(...data.subjects);
  }

  // 単一のオブジェクトとしてまとめる
  const mergedData = {
    totalCount,
    pageSize,
    page: 0, // 全ページのデータを結合した結果なので、page=0 とする
    totalPages,
    relatedTags,
    subjects: allSubjects,
  };

  return mergedData;
}

src/index.ts:199-209 (helper)

Helper function to format the list of simplified subjects into a readable text string.

function formatSimplifiedSubjectsToText(subjects: any[]): string {
  let text = `検索結果: ${subjects.length}件の科目が見つかりました\n\n`;
  
  // 科目名と想定年次のリスト
  const subjectList = subjects.map(subject => formatSimplifiedSubjectToText(subject));
  
  // 1行に1科目ずつ表示
  text += subjectList.join('\n');
  
  return text;
}

src/index.ts:57-81 (helper)

Helper function to get category names from subject category IDs.

function getCategoryName(categoryIds: string[]): string {
  if (!categoryIds || categoryIds.length === 0) {
    return "未分類";
  }

  const categoryMap: Record<string, string> = {
    "basic": "導入科目",
    "applied_informatics": "基盤リテラシー科目 (情報)",
    "mathematical_sciences": "基盤リテラシー科目 (数理)",
    "multilingual_information_understanding": "多言語情報理解科目",
    "culture_and_thoughts": "世界理解科目 (文化・思想)",
    "society_and_networks": "世界理解科目 (社会・ネットワーク)",
    "economy_and_markets": "世界理解科目 (経済・マーケット)",
    "digital_industr": "世界理解科目 (デジタル産業)",
    "social_connection": "社会接続科目",
    "graduation_project": "卒業プロジェクト科目",
    "free": "自由科目"
  };

  // カテゴリーIDに対応する分類名を取得
  const categoryNames = categoryIds.map(id => categoryMap[id] || "未分類");
  
  // 重複を排除
  return [...new Set(categoryNames)].join(", ");
}

ZEN University Syllabus MCP Server