@ampless/mcp-server 1.0.0-alpha.54 → 1.0.0-alpha.56

package/README.ja.md

@@ -62,7 +62,7 @@ import type { ToolDefinition, ToolContext, ResolvedSite } from '@ampless/mcp-ser
 
 | ツール | role | 説明 |
 |---|---|---|
-| `list_posts` | reader | オプションの status フィルターとページネーション付きで投稿一覧を取得 |
+| `list_posts` | reader | 投稿の軽量サマリーを返す（body なし — 本文は `get_post` を使用）。検索/ソート/フィルター対応。`{ posts, total, offset, limit }` を返す |
 | `get_post` | reader | slug または postId で単一の投稿を取得 |
 | `create_post` | editor | 新しい投稿を作成（下書きまたは公開済み） |
 | `update_post` | editor | 既存の投稿のフィールドをパッチ更新 |

package/README.md

@@ -62,7 +62,7 @@ import type { ToolDefinition, ToolContext, ResolvedSite } from '@ampless/mcp-ser
 
 | Tool | Role | Description |
 |---|---|---|
-| `list_posts` | reader | List posts with optional status filter and pagination |
+| `list_posts` | reader | Returns lightweight post summaries (no body — use `get_post` for content) with search / sort / filters. Returns `{ posts, total, offset, limit }` |
 | `get_post` | reader | Fetch a single post by slug or postId |
 | `create_post` | editor | Create a new post (draft or published) |
 | `update_post` | editor | Patch fields on an existing post |

package/dist/index.js

@@ -1,3 +1,6 @@
+// src/tools/list-posts.ts
+import { filterSortPostSummaries } from "ampless";
+
 // src/tools/post-mapping.ts
 import {
   decodeAwsJson
@@ -14,11 +17,28 @@ var POST_FIELDS = (
     body
     status
     publishedAt
+    updatedAt
     tags
     metadata
   }
 `
 );
+var POST_SUMMARY_FIELDS = (
+  /* GraphQL */
+  `
+  fragment PostSummaryFields on Post {
+    postId
+    slug
+    title
+    excerpt
+    format
+    status
+    publishedAt
+    updatedAt
+    tags
+  }
+`
+);
 function toCorePost(p) {
   const metadata = decodeAwsJson(p.metadata);
   return {
@@ -30,20 +50,34 @@ function toCorePost(p) {
     body: decodeAwsJson(p.body),
     status: p.status ?? "draft",
     publishedAt: p.publishedAt ?? void 0,
+    updatedAt: p.updatedAt ?? void 0,
     tags: (p.tags ?? []).filter((t) => typeof t === "string"),
     metadata: metadata && typeof metadata === "object" && !Array.isArray(metadata) ? metadata : void 0
   };
 }
+function toPostSummary(p) {
+  return {
+    postId: p.postId,
+    slug: p.slug,
+    title: p.title,
+    excerpt: p.excerpt ?? void 0,
+    format: p.format ?? "markdown",
+    status: p.status ?? "draft",
+    publishedAt: p.publishedAt ?? void 0,
+    updatedAt: p.updatedAt ?? void 0,
+    tags: (p.tags ?? []).filter((t) => typeof t === "string")
+  };
+}
 
 // src/tools/list-posts.ts
 var QUERY = (
   /* GraphQL */
   `
-  ${POST_FIELDS}
+  ${POST_SUMMARY_FIELDS}
   query ListPosts($filter: ModelPostFilterInput, $limit: Int, $nextToken: String) {
     listPosts(filter: $filter, limit: $limit, nextToken: $nextToken) {
       items {
-        ...PostFields
+        ...PostSummaryFields
       }
       nextToken
     }
@@ -53,29 +87,95 @@ var QUERY = (
 var listPostsSchema = {
   type: "object",
   properties: {
+    query: {
+      type: "string",
+      description: "Case-insensitive substring match over title / slug / tags"
+    },
+    tag: {
+      type: "string",
+      description: "Exact tag filter"
+    },
     status: {
       type: "string",
       enum: ["draft", "published", "all"],
       description: 'Filter by status (default "all")'
     },
-    limit: { type: "integer", minimum: 1, maximum: 100, description: "Max results (default 20)" },
-    nextToken: { type: "string", description: "Pagination cursor from a previous call" }
+    sort: {
+      type: "string",
+      enum: [
+        "updated-desc",
+        "updated-asc",
+        "published-desc",
+        "published-asc",
+        "title-asc",
+        "title-desc"
+      ],
+      description: 'Sort order (default "updated-desc" \u2014 most recently edited first)'
+    },
+    limit: {
+      type: "integer",
+      minimum: 1,
+      maximum: 100,
+      description: "Max results per page (default 20)"
+    },
+    offset: {
+      type: "integer",
+      minimum: 0,
+      description: "Zero-based offset into the filtered result set (default 0)"
+    }
   }
 };
+var VALID_STATUS = /* @__PURE__ */ new Set(["draft", "published", "all"]);
+var VALID_SORT = /* @__PURE__ */ new Set([
+  "updated-desc",
+  "updated-asc",
+  "published-desc",
+  "published-asc",
+  "title-asc",
+  "title-desc"
+]);
+function asString(v) {
+  return typeof v === "string" ? v : void 0;
+}
+function asInt(v, fallback) {
+  const n = Number(v);
+  return Number.isFinite(n) ? Math.trunc(n) : fallback;
+}
 async function listPosts(client, args = {}) {
-  const status = args.status ?? "all";
+  const limit = Math.min(100, Math.max(1, asInt(args.limit, 20)));
+  const offset = Math.max(0, asInt(args.offset, 0));
+  const rawStatus = asString(args.status);
+  const status = rawStatus && VALID_STATUS.has(rawStatus) ? rawStatus : "all";
+  const rawSort = asString(args.sort);
+  const sort = rawSort && VALID_SORT.has(rawSort) ? rawSort : void 0;
+  const query = asString(args.query);
+  const tag = asString(args.tag);
   const filter = {};
   if (status !== "all") filter.status = { eq: status };
   const hasFilter = Object.keys(filter).length > 0;
-  const data = await client.query(QUERY, {
-    filter: hasFilter ? filter : void 0,
-    limit: args.limit ?? 20,
-    nextToken: args.nextToken
+  const allItems = [];
+  let cursor = null;
+  do {
+    const data = await client.query(QUERY, {
+      filter: hasFilter ? filter : void 0,
+      limit: 200,
+      nextToken: cursor
+    });
+    for (const item of data.listPosts.items) {
+      allItems.push(toPostSummary(item));
+    }
+    cursor = data.listPosts.nextToken;
+  } while (cursor);
+  const filtered = filterSortPostSummaries(allItems, {
+    query,
+    tag,
+    sort,
+    // status already applied server-side; pass 'all' to avoid double-filter
+    status: "all"
   });
-  return {
-    posts: data.listPosts.items.map(toCorePost),
-    nextToken: data.listPosts.nextToken
-  };
+  const total = filtered.length;
+  const posts = filtered.slice(offset, offset + limit);
+  return { posts, total, offset, limit };
 }
 
 // src/tools/get-post.ts
@@ -1593,7 +1693,7 @@ async function commitStaticPost(graphql, storage, args) {
 var tools = [
   {
     name: "list_posts",
-    description: "List posts in the CMS with optional filters by status. Returns up to `limit` posts (default 20) plus a `nextToken` cursor for pagination.",
+    description: "Returns lightweight post summaries (no body \u2014 use get_post for content) with search / sort / filters. `total` reflects the filtered count. Supports query (substring over title/slug/tags), tag (exact), status, sort, limit (1\u2013100, default 20), offset (default 0).",
     inputSchema: listPostsSchema,
     handler: (args, ctx) => listPosts(ctx.graphql, args)
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/mcp-server",
-  "version": "1.0.0-alpha.54",
+  "version": "1.0.0-alpha.56",
   "description": "MCP tool registry shared by @ampless/backend mcp-handler Lambda. Installed transitively via @ampless/admin / @ampless/backend; no direct install needed.",
   "publishConfig": {
     "access": "public"
@@ -26,7 +26,7 @@
   "bugs": "https://github.com/heavymoons/ampless/issues",
   "dependencies": {
     "fflate": "^0.8.3",
-    "ampless": "1.0.0-alpha.48"
+    "ampless": "1.0.0-alpha.50"
   },
   "keywords": [
     "ampless",