4장: 서버 프리미티브 - 도구, 리소스, 프롬프트

{
  "name": "create_issue",
  "description": "GitHub 리포지토리에 새 이슈를 생성합니다. 버그 리포트, 기능 요청, 질문 등을 이슈로 등록할 때 사용합니다.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "owner": {
        "type": "string",
        "description": "리포지토리 소유자의 GitHub 사용자명"
      },
      "repo": {
        "type": "string",
        "description": "리포지토리 이름"
      },
      "title": {
        "type": "string",
        "description": "이슈 제목"
      },
      "body": {
        "type": "string",
        "description": "이슈 본문 (Markdown 형식)"
      },
      "labels": {
        "type": "array",
        "items": { "type": "string" },
        "description": "이슈에 붙일 라벨 목록"
      }
    },
    "required": ["owner", "repo", "title"]
  }
}

server.tool(
  "analyze_code",
  "코드를 분석하여 개선 사항을 제안합니다",
  {
    code: { type: "string", description: "분석할 코드" },
    language: { type: "string", description: "프로그래밍 언어" },
  },
  async (params) => {
    const analysis = await performAnalysis(params.code, params.language);
 
    return {
      content: [
        {
          type: "text",
          text: analysis.summary,
        },
        {
          type: "text",
          text: "상세 분석 결과:\n" + analysis.details,
        },
      ],
    };
  }
);

// 텍스트 콘텐츠
{ type: "text", text: "분석 결과입니다" }
 
// 이미지 콘텐츠
{ type: "image", data: "base64EncodedData...", mimeType: "image/png" }
 
// 임베디드 리소스
{
  type: "resource",
  resource: {
    uri: "file:///path/to/result.json",
    text: '{"key": "value"}',
    mimeType: "application/json"
  }
}

server.tool("delete_file", "파일을 삭제합니다", {
  path: { type: "string", description: "삭제할 파일의 절대 경로" },
}, async (params) => {
  try {
    const fs = await import("fs/promises");
    await fs.unlink(params.path);
    return {
      content: [{ type: "text", text: params.path + " 파일이 삭제되었습니다." }],
    };
  } catch (error) {
    return {
      content: [{
        type: "text",
        text: "파일 삭제에 실패했습니다: " + (error as Error).message,
      }],
      isError: true,
    };
  }
});

server.tool(
  "send_email",
  "이메일을 발송합니다",
  { to: { type: "string" }, subject: { type: "string" }, body: { type: "string" } },
  async (params) => {
    // 이메일 발송 로직
    return { content: [{ type: "text", text: "이메일이 발송되었습니다." }] };
  },
  {
    annotations: {
      destructive: true,     // 되돌릴 수 없는 작업
      readOnlyHint: false,   // 읽기 전용이 아님
      idempotent: false,     // 동일 입력으로 재실행 시 다른 결과 가능
      openWorld: true,       // 외부 시스템과 상호작용
    }
  }
);

server.resource(
  "project-config",
  "file:///project/config.json",
  { description: "프로젝트 설정 파일", mimeType: "application/json" },
  async () => ({
    contents: [{
      uri: "file:///project/config.json",
      text: JSON.stringify(projectConfig, null, 2),
      mimeType: "application/json",
    }],
  })
);

server.resourceTemplate(
  "db-record",
  "db:///{table}/{id}",
  { description: "데이터베이스 레코드", mimeType: "application/json" },
  async (uri, params) => {
    const record = await db.query(
      "SELECT * FROM " + params.table + " WHERE id = " + params.id
    );
    return {
      contents: [{
        uri: uri.toString(),
        text: JSON.stringify(record),
        mimeType: "application/json",
      }],
    };
  }
);

server.resource(
  "project-structure",
  "project://structure",
  { description: "프로젝트 디렉토리 구조" },
  async () => ({
    contents: [{
      uri: "project://structure",
      text: await generateDirectoryTree("./src"),
    }],
  })
);
 
server.resource(
  "coding-standards",
  "project://standards",
  { description: "팀 코딩 표준 및 규칙" },
  async () => ({
    contents: [{
      uri: "project://standards",
      text: await readFile("./.cursor/rules.md"),
    }],
  })
);

server.resource(
  "db-schema",
  "db://schema",
  { description: "데이터베이스 전체 스키마" },
  async () => ({
    contents: [{
      uri: "db://schema",
      text: await getSchemaDefinition(),
      mimeType: "application/json",
    }],
  })
);

server.prompt(
  "code-review",
  "코드 리뷰를 수행합니다",
  [
    { name: "code", description: "리뷰할 코드", required: true },
    { name: "language", description: "프로그래밍 언어", required: false },
    { name: "focus", description: "집중할 영역 (security/performance/readability)", required: false },
  ],
  async (params) => ({
    messages: [
      {
        role: "user",
        content: {
          type: "text",
          text: [
            "다음 " + (params.language || "") + " 코드를 리뷰해 주세요.",
            params.focus ? "특히 " + params.focus + "에 집중해 주세요." : "",
            "",
            "리뷰 관점:",
            "1. 버그 가능성",
            "2. 보안 취약점",
            "3. 성능 개선 여지",
            "4. 코드 가독성",
            "5. 모범 사례 준수 여부",
            "",
            "코드:",
            "```" + (params.language || ""),
            params.code,
            "```",
          ].filter(Boolean).join("\n"),
        },
      },
    ],
  })
);

server.prompt(
  "debug-error",
  "에러를 분석하고 수정 방안을 제시합니다",
  [
    { name: "error_message", description: "에러 메시지", required: true },
  ],
  async (params) => {
    const recentLogs = await getRecentLogs();
    const config = await getAppConfig();
 
    return {
      messages: [
        {
          role: "user",
          content: {
            type: "text",
            text: "다음 에러를 분석하고 수정 방안을 제시해 주세요.\n\n에러: " + params.error_message,
          },
        },
        {
          role: "user",
          content: {
            type: "resource",
            resource: {
              uri: "app://logs/recent",
              text: recentLogs,
              mimeType: "text/plain",
            },
          },
        },
        {
          role: "user",
          content: {
            type: "resource",
            resource: {
              uri: "app://config",
              text: JSON.stringify(config, null, 2),
              mimeType: "application/json",
            },
          },
        },
      ],
    };
  }
);

{
  "roots": [
    { "uri": "file:///home/user/project", "name": "메인 프로젝트" },
    { "uri": "file:///home/user/config", "name": "설정 디렉토리" }
  ]
}

{
  "method": "elicitation/create",
  "params": {
    "message": "데이터베이스 연결 정보를 입력해 주세요.",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "host": { "type": "string", "description": "호스트 주소" },
        "port": { "type": "number", "description": "포트 번호" },
        "database": { "type": "string", "description": "데이터베이스 이름" }
      },
      "required": ["host", "database"]
    }
  }
}