Qiita API MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:61-64 (handler)

  Handler for the 'get_users' tool. It uses paginationSchema for input validation and delegates execution to QiitaApiClient.getUsers with page and perPage parameters.

  get_users: {
    schema: paginationSchema,
    execute: async ({ page, perPage }, client) => client.getUsers(page, perPage),
  },

• src/tools/definitions.ts:27-46 (schema)

  MCP Tool definition for 'get_users', including name, description, and input schema for pagination parameters.

  {
    name: 'get_users',
    description: 'ユーザー一覧を取得します',
    inputSchema: {
      type: 'object',
      properties: {
        page: {
          type: 'number',
          description: 'ページ番号（1-100）',
          default: 1,
        },
        perPage: {
          type: 'number',
          description: '1ページあたりの件数（1-100）',
          default: 20,
        },
      },
      required: [],
    },
  },

• src/qiitaApiClient.ts:29-34 (helper)

  QiitaApiClient.getUsers method that performs the actual API call to fetch users list from Qiita's /users endpoint with pagination.

  async getUsers(page = 1, perPage = 20) {
    const response = await this.client.get('/users', {
      params: { page, per_page: perPage },
    });
    return response.data;
  }

• src/tools/handlers.ts:10-13 (schema)

  Zod schema used by the get_users handler for input validation (pagination parameters).

  const paginationSchema = z.object({
    page: z.number().int().min(1).max(100).default(1),
    perPage: z.number().int().min(1).max(100).default(20),
  });