Qiita MCP Server

Instructions

Implementation Reference

• src/index.ts:383-395 (handler)

  Handler code in the CallToolRequestSchema that executes the get_user_stocks tool by validating the user_id argument and calling the QiitaClient's getUserStocks method.

  case "get_user_stocks": {
    if (!args?.user_id) {
      throw new Error("user_id is required");
    }
    const result = await qiitaClient.getUserStocks(
      args.user_id as string,
      args?.page as number | undefined,
      args?.per_page as number | undefined
    );
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }

• src/index.ts:258-283 (schema)

  Schema definition for the get_user_stocks tool, including input schema with properties for user_id (required), page, and per_page.

  {
    name: "get_user_stocks",
    description: "Get articles that a user has stocked (bookmarked).",
    inputSchema: {
      type: "object",
      properties: {
        user_id: {
          type: "string",
          description: "User ID",
        },
        page: {
          type: "number",
          description: "Page number (1-100, default: 1)",
          minimum: 1,
          maximum: 100,
        },
        per_page: {
          type: "number",
          description: "Items per page (1-100, default: 20)",
          minimum: 1,
          maximum: 100,
        },
      },
      required: ["user_id"],
    },
  },

• src/index.ts:110-121 (helper)

  Helper method in QiitaClient class that implements the core logic of fetching a user's stocked articles from the Qiita API endpoint /users/{userId}/stocks.

  async getUserStocks(
    userId: string,
    page: number = 1,
    perPage: number = 20
  ): Promise<any[]> {
    const params = new URLSearchParams({
      page: page.toString(),
      per_page: perPage.toString(),
    });
  
    return this.fetch(`/users/${userId}/stocks?${params.toString()}`);
  }

• src/index.ts:303-305 (registration)

  Registration of the list_tools capability where the tools array (including get_user_stocks) is returned.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return { tools };
  });