@esaio/esa-mcp-server 0.1.0 → 0.2.0

package/src/generated/api-types.ts

@@ -493,6 +493,13 @@ export interface paths {
         query?: {
           /** @description 追加で含める情報（カンマ区切り） */
           include?: components["parameters"]["include"];
+          /**
+           * @description 本文中のsecure attachment URL（https://files.esa.io/ または https://dl.esa.io/）を署名付きURLに変換するかどうか。
+           *     - `false`: 変換しない（デフォルト）
+           *     - `true`: 60秒の有効期限で署名付きURLに変換
+           *     - 整数値（1-604800）: 指定した秒数の有効期限で署名付きURLに変換
+           */
+          sign_attachment_urls?: components["parameters"]["sign_attachment_urls"];
         };
         header?: never;
         path: {
@@ -783,6 +790,13 @@ export interface paths {
         query?: {
           /** @description 追加で含める情報 */
           include?: "stargazers";
+          /**
+           * @description 本文中のsecure attachment URL（https://files.esa.io/ または https://dl.esa.io/）を署名付きURLに変換するかどうか。
+           *     - `false`: 変換しない（デフォルト）
+           *     - `true`: 60秒の有効期限で署名付きURLに変換
+           *     - 整数値（1-604800）: 指定した秒数の有効期限で署名付きURLに変換
+           */
+          sign_attachment_urls?: components["parameters"]["sign_attachment_urls"];
         };
         header?: never;
         path: {
@@ -1509,6 +1523,77 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/v1/teams/{team_name}/categories/paths": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * カテゴリパス一覧取得
+     * @description チームのカテゴリパスの一覧を取得します。フィルタリングオプションにより、特定の条件に合致するカテゴリのみを取得できます
+     */
+    get: {
+      parameters: {
+        query?: {
+          /** @description 指定した文字列で始まるカテゴリパスのみを取得 */
+          prefix?: string;
+          /** @description 指定した文字列で終わるカテゴリパスのみを取得 */
+          suffix?: string;
+          /** @description 指定した文字列を含むカテゴリパスのみを取得 */
+          match?: string;
+          /** @description 指定したパスと完全一致するカテゴリのみを取得 */
+          exact_match?: string;
+        };
+        header?: never;
+        path: {
+          /** @description チーム名 */
+          team_name: components["parameters"]["team_name"];
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description 成功 */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": {
+              /**
+               * @description カテゴリのパス（先頭と末尾のスラッシュは除去される）
+               * @example dev/docs
+               */
+              path: string | null;
+              /**
+               * @description カテゴリ内の記事数
+               * @example 42
+               */
+              posts: number;
+            }[];
+          };
+        };
+        400: components["responses"]["BadRequestError"];
+        401: components["responses"]["UnauthorizedError"];
+        402: components["responses"]["PaymentRequiredError"];
+        403: components["responses"]["ForbiddenError"];
+        404: components["responses"]["NotFoundError"];
+        405: components["responses"]["MethodNotAllowedError"];
+        406: components["responses"]["NotAcceptableError"];
+        429: components["responses"]["TooManyRequestsError"];
+        500: components["responses"]["InternalServerError"];
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/v1/teams/{team_name}/categories/batch_move": {
     parameters: {
       query?: never;
@@ -2020,6 +2105,171 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/v1/teams/{team_name}/signed_urls": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * 署名付きURL取得（複数）
+     * @description 複数のファイルパスに対して署名付きURLを取得します。
+     *     最大10個のURLを一度に処理できます。
+     */
+    get: {
+      parameters: {
+        query: {
+          /**
+           * @description カンマ区切りのファイルパス（最大10個）
+           * @example /uploads/example/file1.png,/uploads/example/file2.png
+           */
+          urls: string;
+          /**
+           * @description 署名付きURLの有効期限（秒数）。1〜604800（1週間）の範囲で指定可能。指定しない場合はデフォルトの60秒
+           * @example 3600
+           */
+          expires_in?: number;
+          /**
+           * @description 署名付きURLのフォーマットバージョン。
+           *     2を指定すると esa-signed-url-v2 形式の署名付きURLが返されます。
+           *     指定しない場合は従来の形式が使用されます。
+           * @example 2
+           */
+          v?: 2;
+        };
+        header?: never;
+        path: {
+          /** @description チーム名 */
+          team_name: components["parameters"]["team_name"];
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description 成功 */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": {
+              /**
+               * @description 入力URLと署名付きURLのペアの配列。
+               *     各要素は[入力URL, 署名付きURL]の形式。
+               *     ファイルが見つからない場合、署名付きURLはnullになります。
+               * @example [
+               *       [
+               *         "/uploads/example/file1.png",
+               *         "https://s3.amazonaws.com/bucket/uploads/example/file1.png?signature=..."
+               *       ],
+               *       [
+               *         "uploads/example/file2.png",
+               *         "https://s3.amazonaws.com/bucket/uploads/example/file2.png?signature=..."
+               *       ]
+               *     ]
+               */
+              signed_urls?: string[][];
+            };
+          };
+        };
+        400: components["responses"]["BadRequestError"];
+        401: components["responses"]["UnauthorizedError"];
+        402: components["responses"]["PaymentRequiredError"];
+        403: components["responses"]["ForbiddenError"];
+        405: components["responses"]["MethodNotAllowedError"];
+        406: components["responses"]["NotAcceptableError"];
+        429: components["responses"]["TooManyRequestsError"];
+        500: components["responses"]["InternalServerError"];
+      };
+    };
+    put?: never;
+    /**
+     * 署名付きURL取得（複数）
+     * @description 複数のファイルパスに対して署名付きURLを取得します。
+     *     最大1000個のURLを一度に処理できます。
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          /** @description チーム名 */
+          team_name: components["parameters"]["team_name"];
+        };
+        cookie?: never;
+      };
+      requestBody: {
+        content: {
+          "application/json": {
+            /**
+             * @description ファイルパスの配列（最大1000個）
+             * @example [
+             *       "/uploads/example/file1.png",
+             *       "uploads/example/file2.png",
+             *       "https://example.com/uploads/example/file3.png"
+             *     ]
+             */
+            urls: string[];
+            /**
+             * @description 署名付きURLの有効期限（秒数）。1〜604800（1週間）の範囲で指定可能。指定しない場合はデフォルトの60秒
+             * @example 3600
+             */
+            expires_in?: number;
+            /**
+             * @description 署名付きURLのフォーマットバージョン。
+             *     2を指定すると esa-signed-url-v2 形式の署名付きURLが返されます。
+             *     指定しない場合は従来の形式が使用されます。
+             * @example 2
+             * @enum {integer}
+             */
+            v?: 2;
+          };
+        };
+      };
+      responses: {
+        /** @description 成功 */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": {
+              /**
+               * @description 入力URLと署名付きURLのペアの配列。
+               *     各要素は[入力URL, 署名付きURL]の形式。
+               *     ファイルが見つからない場合、署名付きURLはnullになります。
+               * @example [
+               *       [
+               *         "/uploads/example/file1.png",
+               *         "https://s3.amazonaws.com/bucket/uploads/example/file1.png?signature=..."
+               *       ],
+               *       [
+               *         "uploads/example/file2.png",
+               *         "https://s3.amazonaws.com/bucket/uploads/example/file2.png?signature=..."
+               *       ]
+               *     ]
+               */
+              signed_urls?: string[][];
+            };
+          };
+        };
+        400: components["responses"]["BadRequestError"];
+        401: components["responses"]["UnauthorizedError"];
+        402: components["responses"]["PaymentRequiredError"];
+        403: components["responses"]["ForbiddenError"];
+        405: components["responses"]["MethodNotAllowedError"];
+        406: components["responses"]["NotAcceptableError"];
+        429: components["responses"]["TooManyRequestsError"];
+        500: components["responses"]["InternalServerError"];
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/v1/user": {
     parameters: {
       query?: never;
@@ -2496,7 +2746,7 @@ export interface components {
         categories: components["schemas"]["Category"][];
       }[];
       /** @description READMEの記事情報 */
-      readme?: components["schemas"]["Post"];
+      readme?: components["schemas"]["Post"] | null;
       /** @description カテゴリなし記事の情報（topカテゴリの場合） */
       no_category?: components["schemas"]["Category"];
       /** @description 子孫記事を含むかどうか */
@@ -2542,10 +2792,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Bad Request",
          *       "message": "Invalid request parameters"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2555,10 +2807,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Unauthorized",
          *       "message": "Invalid or expired token"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2568,10 +2822,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Payment Required",
          *       "message": "Payment required to access this resource"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2581,10 +2837,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Forbidden",
          *       "message": "Insufficient permissions"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2594,10 +2852,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Not Found",
          *       "message": "Resource not found"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2607,10 +2867,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Method Not Allowed",
          *       "message": "HTTP method not allowed for this endpoint"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2620,10 +2882,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Not Acceptable",
          *       "message": "Requested format not supported"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2633,10 +2897,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Conflict",
          *       "message": "Resource conflict detected"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2648,10 +2914,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Too Many Requests",
          *       "message": "Rate limit exceeded"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2661,10 +2929,12 @@ export interface components {
         [name: string]: unknown;
       };
       content: {
-        /** @example {
+        /**
+         * @example {
          *       "error": "Internal Server Error",
          *       "message": "An unexpected error occurred"
-         *     } */
+         *     }
+         */
         "application/json": components["schemas"]["Error"];
       };
     };
@@ -2682,6 +2952,13 @@ export interface components {
     comment_id: number;
     /** @description 追加で含める情報（カンマ区切り） */
     include: "comments" | "stargazers" | "comments.stargazers";
+    /**
+     * @description 本文中のsecure attachment URL（https://files.esa.io/ または https://dl.esa.io/）を署名付きURLに変換するかどうか。
+     *     - `false`: 変換しない（デフォルト）
+     *     - `true`: 60秒の有効期限で署名付きURLに変換
+     *     - 整数値（1-604800）: 指定した秒数の有効期限で署名付きURLに変換
+     */
+    sign_attachment_urls: boolean | number;
   };
   requestBodies: never;
   headers: never;

package/src/prompts/__tests__/index.test.ts

@@ -1,4 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MockInstance } from "vitest";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { MCPContext } from "../../context/mcp-context.js";
 import { setupPrompts } from "../index.js";
@@ -6,7 +7,7 @@ import { setupPrompts } from "../index.js";
 describe("setupPrompts", () => {
   let server: McpServer;
   let context: MCPContext;
-  let consoleErrorSpy: ReturnType<typeof vi.spyOn>;
+  let consoleErrorSpy: MockInstance<typeof console.error>;
 
   beforeEach(() => {
     server = new McpServer({

package/src/prompts/index.ts

@@ -7,7 +7,7 @@ import { createSummarizePostSchema, summarizePost } from "./summarize-post.js";
 
 export function setupPrompts(server: McpServer, context: MCPContext): void {
   console.error("Setting up MCP prompts...");
-  // NOTE: Stremable HTTP Stransport では ユーザーの LANG 設定に応じて i18next の lang 設定を変える
+  // NOTE: Streamable HTTP transport では ユーザーの LANG 設定に応じて i18next の lang 設定を変える
   server.registerPrompt(
     "esa_summarize_post",
     {

package/src/resources/__tests__/index.test.ts

@@ -1,4 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MockInstance } from "vitest";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { MCPContext } from "../../context/mcp-context.js";
 import { setupResources } from "../index.js";
@@ -6,7 +7,7 @@ import { setupResources } from "../index.js";
 describe("setupResources", () => {
   let server: McpServer;
   let context: MCPContext;
-  let consoleErrorSpy: ReturnType<typeof vi.spyOn>;
+  let consoleErrorSpy: MockInstance<typeof console.error>;
 
   beforeEach(() => {
     server = new McpServer({

package/src/resources/__tests__/recent-posts-list.test.ts

@@ -1,3 +1,4 @@
+import type { MockInstance } from "vitest";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { withContext } from "../../api_client/with-context.js";
 import type { MCPContext } from "../../context/mcp-context.js";
@@ -9,7 +10,7 @@ vi.mock("../../tools/teams.js");
 
 describe("createRecentPostsResourceList", () => {
   let context: MCPContext;
-  let consoleErrorSpy: ReturnType<typeof vi.spyOn>;
+  let consoleErrorSpy: MockInstance<typeof console.error>;
 
   beforeEach(() => {
     context = {} as unknown as MCPContext;