SwitchBot MCP Server

Instructions

Implementation Reference

• src/index.ts:147-168 (handler)

  The handler function for the 'get_device_status' tool. It validates the deviceId parameter, makes an API call to SwitchBot's /devices/{deviceId}/status endpoint using the configured axios instance, and returns the response body as JSON text.

  case 'get_device_status': {
      const args = request.params.arguments;
      if (!args || typeof args.deviceId !== 'string') {
          throw new McpError(
              ErrorCode.InvalidParams,
              'デバイスIDが必要です'
          );
      }
  
      const response = await this.axiosInstance.get(
          `/devices/${args.deviceId}/status`
      );
  
      return {
          content: [
              {
                  type: 'text',
                  text: JSON.stringify(response.data.body, null, 2),
              },
          ],
      };
  }

• src/index.ts:96-110 (registration)

  Registration of the 'get_device_status' tool in the ListToolsRequestSchema handler's tools array, specifying name, description, and input schema.

  {
      name: 'get_device_status',
      description: 'デバイスのステータスを取得します',
      inputSchema: {
          type: 'object',
          properties: {
              deviceId: {
                  type: 'string',
                  description: 'デバイスID',
              },
          },
          required: ['deviceId'],
      },
  },
  {

• src/index.ts:99-108 (schema)

  Input schema definition for the 'get_device_status' tool, requiring a 'deviceId' string.

  inputSchema: {
      type: 'object',
      properties: {
          deviceId: {
              type: 'string',
              description: 'デバイスID',
          },
      },
      required: ['deviceId'],
  },