get_user_followers
Retrieve a list of followers for a specific Qiita user. Use this tool to access user follower data with pagination controls for efficient browsing.
Instructions
指定されたユーザーのフォロワー一覧を取得します
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| userId | Yes | ユーザーID | |
| page | No | ページ番号（1-100） | |
| perPage | No | 1ページあたりの件数（1-100） |
Implementation Reference
- src/tools/handlers.ts:75-79 (handler)The handler definition for the 'get_user_followers' tool, including Zod schema for input validation and the execute function that delegates to the QiitaApiClient.
get_user_followers: { schema: userIdSchema.merge(paginationSchema), execute: async ({ userId, page, perPage }, client) => client.getUserFollowers(userId, page, perPage), }, - src/tools/definitions.ts:95-118 (schema)The MCP tool schema definition for 'get_user_followers', including name, description, and input schema used for listing tools.
{ name: 'get_user_followers', description: '指定されたユーザーのフォロワー一覧を取得します', inputSchema: { type: 'object', properties: { userId: { type: 'string', description: 'ユーザーID', }, page: { type: 'number', description: 'ページ番号（1-100）', default: 1, }, perPage: { type: 'number', description: '1ページあたりの件数（1-100）', default: 20, }, }, required: ['userId'], }, }, - src/index.ts:30-65 (registration)The MCP server registration for tool calls, where toolHandlers[name] is retrieved, input is parsed with the handler's schema, and the execute function is invoked with the Qiita client.
server.setRequestHandler(CallToolRequestSchema, async (request) => { const { name, arguments: args } = request.params; const accessToken = process.env.QIITA_ACCESS_TOKEN; const qiita = new QiitaApiClient(accessToken); const handler = toolHandlers[name]; try { if (!handler) { throw new Error(`未知のツール: ${name}`); } const parsedArgs = handler.schema.parse(args ?? {}); const result = await handler.execute(parsedArgs, qiita); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; } catch (error: any) { const message = error?.message ?? String(error); return { content: [ { type: 'text', text: `エラーが発生しました: ${message}`, }, ], isError: true, }; } }); - src/qiitaApiClient.ts:50-55 (helper)The helper method in QiitaApiClient that performs the actual HTTP request to fetch the user's followers from the Qiita API.
async getUserFollowers(userId: string, page = 1, perPage = 20) { const response = await this.client.get(`/users/${userId}/followers`, { params: { page, per_page: perPage }, }); return response.data; }