ZenTao MCP Server

Instructions

Implementation Reference

• src/zentao-mcp-server.js:590-601 (handler)

  Handler function that destructures arguments, calls the listProducts helper, and returns the products as JSON in the MCP response format.

  if (name === "searchProducts") {
    const { keyword, limit } = args;
    const products = await listProducts({ keyword, limit });
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({ products }, null, 2),
        },
      ],
    };
  }

• src/zentao-mcp-server.js:427-440 (registration)

  Tool registration in the listTools response, including name, description, and input schema.

  {
    name: "searchProducts",
    description: "Search products by keyword; returns a short list of products.",
    inputSchema: {
      type: "object",
      properties: {
        keyword: { type: "string", description: "Keyword to match product name" },
        limit: { type: "number", description: "Max items", default: 20 },
      },
      required: [],
      additionalProperties: false,
    },
  },
  {

• src/zentao-mcp-server.js:430-439 (schema)

  Input schema defining parameters for keyword and optional limit.

    inputSchema: {
      type: "object",
      properties: {
        keyword: { type: "string", description: "Keyword to match product name" },
        limit: { type: "number", description: "Max items", default: 20 },
      },
      required: [],
      additionalProperties: false,
    },
  },

• src/zentao-mcp-server.js:210-222 (helper)

  Core helper function that fetches products from ZenTao API, filters by keyword if provided, and limits results.

  async function listProducts({ keyword, limit = 20 } = {}) {
    const res = await callZenTao({
      path: "products",
      query: { page: 1, limit, keywords: keyword },
    });
    const products = extractArray(res.data, ["products"]);
    const filtered = keyword
      ? products.filter((p) =>
          `${p.name || ""}`.toLowerCase().includes(keyword.toLowerCase())
        )
      : products;
    return filtered.slice(0, limit);
  }