Freesound MCP Server

Instructions

Implementation Reference

• src/index.ts:281-291 (handler)

  MCP server tool handler for 'get_user': extracts username from args, calls FreesoundClient.getUser, and returns JSON stringified user data.

  case "get_user": {
    const user = await freesoundClient.getUser(args.username as string);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(user, null, 2),
        },
      ],
    };
  }

• src/index.ts:132-145 (registration)

  Registration of the 'get_user' tool in the ListTools handler, including name, description, and input schema.

  {
    name: "get_user",
    description: "Get information about a Freesound user",
    inputSchema: {
      type: "object",
      properties: {
        username: {
          type: "string",
          description: "The username of the user",
        },
      },
      required: ["username"],
    },
  },

• src/index.ts:135-144 (schema)

  Input schema for the 'get_user' tool: requires 'username' string.

  inputSchema: {
    type: "object",
    properties: {
      username: {
        type: "string",
        description: "The username of the user",
      },
    },
    required: ["username"],
  },

• src/freesound-client.ts:192-195 (helper)

  Core implementation of getUser in FreesoundClient: makes API GET request to /users/{username}/ and returns the User data.

  async getUser(username: string): Promise<User> {
    const response = await this.axiosInstance.get(`/users/${username}/`);
    return response.data;
  }

• src/freesound-client.ts:65-83 (schema)

  TypeScript interface defining the User object returned by getUser.

  export interface User {
    url: string;
    username: string;
    about: string;
    home_page: string;
    avatar: {
      small: string;
      medium: string;
      large: string;
    };
    date_joined: string;
    num_sounds: number;
    sounds: string;
    num_packs: number;
    packs: string;
    num_posts: number;
    num_comments: number;
    bookmark_categories: string;
  }