Manalink MCP Server

Instructions

Implementation Reference

• src/server.ts:62-75 (handler)

  The handler function for the 'get_grade_master' tool. It combines imported 'grades' and 'gradeGroups' data into a response object and returns it as a formatted JSON text content.

  async () => {
    // 学年マスタと学年グループを組み合わせた情報を返す
    const response = {
      grades,
      gradeGroups
    };
  
    return {
      content: [{
        type: "text" as const,
        text: JSON.stringify(response, null, 2)
      }]
    };
  }

• src/server.ts:59-76 (registration)

  Registers the 'get_grade_master' tool with the MCP server, specifying the tool name, Japanese description, and inline handler function.

  server.tool(
    "get_grade_master",
    "学年マスタを取得します。このマスタの取得を通じて、学年のラベルとIDの対応を取得します。",
    async () => {
      // 学年マスタと学年グループを組み合わせた情報を返す
      const response = {
        grades,
        gradeGroups
      };
  
      return {
        content: [{
          type: "text" as const,
          text: JSON.stringify(response, null, 2)
        }]
      };
    }
  );

• src/masters/grades.ts:4-39 (helper)

  Defines the data structures and static data arrays for grades and grade groups, which are imported and used directly in the tool handler.

  export interface Grade {
    id: number;
    name: string;
  }
  
  export const grades: Grade[] = [
    { id: 1, name: "小学1年生" },
    { id: 2, name: "小学2年生" },
    { id: 3, name: "小学3年生" },
    { id: 4, name: "小学4年生" },
    { id: 5, name: "小学5年生" },
    { id: 6, name: "小学6年生" },
    { id: 7, name: "中学1年生" },
    { id: 8, name: "中学2年生" },
    { id: 9, name: "中学3年生" },
    { id: 10, name: "中学浪人" },
    { id: 11, name: "高校1年生" },
    { id: 12, name: "高校2年生" },
    { id: 13, name: "高校3年生" },
    { id: 14, name: "浪人生" },
    { id: 15, name: "社会人" }
  ];
  
  /**
   * 学年グループ定義（中学生、高校生などの広いカテゴリ）
   */
  export interface GradeGroup {
    name: string;
    gradeIds: number[];
  }
  
  export const gradeGroups: GradeGroup[] = [
    { name: "小学生", gradeIds: [1, 2, 3, 4, 5, 6] },
    { name: "中学生", gradeIds: [7, 8, 9, 10] },
    { name: "高校生", gradeIds: [11, 12, 13] }
  ];