Qiita MCP Server

Instructions

Implementation Reference

• src/index.ts:79-90 (handler)

  Core handler function in QiitaClient that fetches and returns Qiita items authored by a specific user via the API.

  async getItemsByUser(
    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}/items?${params.toString()}`);
  }

• src/index.ts:195-216 (schema)

  Input schema definition for the get_items_by_user tool, specifying parameters and validation.

  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:192-217 (registration)

  Tool registration in the tools array, defining name, description, and schema for list tools response.

  {
    name: "get_items_by_user",
    description: "Get articles written by a specific user.",
    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:348-360 (handler)

  Dispatch handler in the CallToolRequestSchema handler that validates input and calls the QiitaClient method for get_items_by_user.

  case "get_items_by_user": {
    if (!args?.user_id) {
      throw new Error("user_id is required");
    }
    const result = await qiitaClient.getItemsByUser(
      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:24-43 (helper)

  Helper fetch method used by QiitaClient methods to make authenticated API requests to Qiita.

  private async fetch(endpoint: string): Promise<any> {
    const headers: HeadersInit = {
      "Content-Type": "application/json",
    };
  
    if (this.accessToken) {
      headers["Authorization"] = `Bearer ${this.accessToken}`;
    }
  
    const response = await fetch(`${this.baseUrl}${endpoint}`, { headers });
  
    if (!response.ok) {
      const errorBody = await response.text();
      throw new Error(
        `Qiita API error: ${response.status} ${response.statusText} - ${errorBody}`
      );
    }
  
    return response.json();
  }