note.com MCP Server

Instructions

Implementation Reference

• src/tools/search-tools.ts:126-151 (registration)

  Exact registration of the 'search-users' tool, including inline Zod schema for parameters (query, size, start) and the handler function that performs API request to /v3/searches?context=user, extracts and formats users using safeExtractData and formatUser, and returns paginated results.

  server.tool(
    "search-users",
    "ユーザーを検索する",
    {
      query: z.string().describe("検索キーワード"),
      size: z.number().default(10).describe("取得する件数（最大20）"),
      start: z.number().default(0).describe("検索結果の開始位置"),
    },
    async ({ query, size, start }) => {
      try {
        const data = await noteApiRequest(`/v3/searches?context=user&q=${encodeURIComponent(query)}&size=${size}&start=${start}`);
  
        const usersArray = safeExtractData(data, commonExtractors.users);
        const totalCount = safeExtractTotal(data, usersArray.length);
        
        const formattedUsers = usersArray.map((user: any) => formatUser(user));
  
        return createSuccessResponse({
          total: totalCount,
          users: formattedUsers
        });
      } catch (error) {
        return handleApiError(error, "ユーザー検索");
      }
    }
  );

• src/tools/index.ts:17-17 (registration)

  Calls registerSearchTools which includes the search-users tool registration.

  registerSearchTools(server);

• src/note-mcp-server-refactored.ts:41-41 (registration)

  Top-level call to registerAllTools during server initialization, which chains to search-users registration.

  registerAllTools(server);