Qiita API MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:100-103 (handler)

  The execution handler for the 'update_item' MCP tool, which destructures itemId from input and forwards the remaining fields as update data to the QiitaApiClient's updateItem method.

  update_item: {
    schema: updateItemSchema,
    execute: async ({ itemId, ...rest }, client) => client.updateItem(itemId, rest),
  },

• src/tools/handlers.ts:44-50 (schema)

  Zod schema used for runtime input validation of the update_item tool handler.

  const updateItemSchema = z.object({
    itemId: z.string(),
    title: z.string(),
    body: z.string(),
    tags: z.array(tagSpecificationSchema),
    private: z.boolean().optional(),
  });

• src/tools/definitions.ts:230-277 (registration)

  MCP Tool definition object for 'update_item', including name, description, and JSON inputSchema used for tool listing and validation.

  {
    name: 'update_item',
    description: '既存の記事を更新します',
    inputSchema: {
      type: 'object',
      properties: {
        itemId: {
          type: 'string',
          description: '記事ID',
        },
        title: {
          type: 'string',
          description: '記事のタイトル',
        },
        body: {
          type: 'string',
          description: '記事の本文（Markdown形式）',
        },
        tags: {
          type: 'array',
          description: 'タグの配列',
          items: {
            type: 'object',
            properties: {
              name: {
                type: 'string',
                description: 'タグ名',
              },
              versions: {
                type: 'array',
                description: 'タグのバージョン',
                items: {
                  type: 'string',
                },
              },
            },
            required: ['name', 'versions'],
          },
        },
        private: {
          type: 'boolean',
          description: '非公開記事かどうか',
          default: false,
        },
      },
      required: ['itemId', 'title', 'body', 'tags'],
    },
  },

• src/qiitaApiClient.ts:88-97 (helper)

  Low-level API client method that sends a PATCH request to Qiita's /items/{itemId} endpoint to update the item, called by the tool handler.

  async updateItem(itemId: string, item: {
    title: string;
    body: string;
    tags: Array<{ name: string; versions: string[] }>;
    private?: boolean;
  }) {
    this.assertAuthenticated();
    const response = await this.client.patch(`/items/${itemId}`, item);
    return response.data;
  }